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Abstract? 
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MACLISP tor the. ITS, TE&50 and TEMEX PtJP-lQ «y*EemE. and MUTCS. The r»1*tfo# 
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Section I. Whj Imptement LOCO In HSP 



LI$P has. proved itself to be a powerful language for represenlme. comple* 
information proteasing tasks. This, power stem? from: 

1. Tha uniform representation ol programs and dill, 

3. The ability to build arbitrarily complex dais structures in (he form of s -expressions. 

3. Recursion. 

Pawer> however, is- rflt necessarily good pedagogy, LOGO is i computer language 
designed especially for the beginner. Its purpose I* trj introduce the «undarn*ri(*f ideas 
oF ccmputalion as dearly ■= possible. 

LISP LOGO is an implement il ion of LOGO in USP. Lt ties been designed i Dr E evcr»| 
reasons. The first is. that t^*so No languages share a fundamenlaF core m common. 
Both are Wwx shared, interpretive languages capable of fv»l recursion. variabte and! 
procedure names tiay be any string of letters and digits. Sub-procedure definitions are 
incSependent ol super-procedures, Both numsc'cal and list -structured information can be 
manipulated with aqual laeility. Thus, the LOGO syslenvs programmer is treed of the 
necessity Ol re-developing various fetiMies already available in LlSP {Irsfs, recursion, 
garbage collection, error service traps, interrupts). He can concentrate On additions 
(better error analysis) and modifications <, pedagogic at Hmpli(icaliont3 to LISP- LLOGO 
unifies language development across a broad spectrum rinjing IfOm PLANNER and 
CONNIVER through USP to LOGO. 

A second reason lor this implementation is to provide a rujlvri Iransition 10 the 
mare powerful computational world of USP Is Ihe studenl grows more sophisticated. 
When desired, the student has attess to all of 1 he capabilities of USP including: 

Arrays 

Functions ot arbitrary number of inputs 

Functions that do not tvaluate IheJr inputs 

t*CfiO-PUNNER end COKMVEP 

Interrupts 

LISP compiler 

Property lists 

Floating point numbers 

Character display cursor manipulation 

Inlinite precision fisced poinl arithmetic 



Wry rmpleiniHil LOBG in USP &**» ■ 
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Section 2. Dlfffrenm betwrtJi LOGO ind LISP 



The differences between LOGO and USF can be descibeo" On the basis til thrift 
educational goals: 

Simplicity of both the computational »iy| explanatory kind, 

Njhfrjln«t wherein the Overhead for a r-aive user 15 minimised by following 

standard English conveniens. 

Dspanly which emphasizes the dis'<nc' on between various modes such as 

c*el«n»ng versus running program** 

It hhciulj hn ncilfl-ri, however, |h*t there cart be- no one unique solution to the 
"best" cducaliOnal language; These three goals can conFlicl. Furth* r mire, »hpy canrwl be 
so emphasised thai important ideas of computation are completely eliminated Irani the 
language. For students of dilferent backgrounds, simplicity and naturalness may hive 
very dilfe-rent meanings. Hence, alternatives to the particular choices made In designing 
CLOGO and ILL 000 are also described. This section may be viewed as presenting a 
spectrum of pOssibilites from which a leather can build a cOmputaliOnal world tailored to 
hi* own pedagogical purposes, 



2 t Simplicity 

Lists versus Sentences 

Lists, have a simple recursive- delmltion. A Hst Is either 

1, ML, the- empty lilt 

2, {word L word's ,, r ),i sequence of wprds {■ atoms} 

3, A lisl of lists. 

This dclinitign is confusing when the sludenl is slill having trouble with the concept Of 
recursion. CtQGO limits itsell to lists built from only the first two of these !hree clauses. 
Such lists are calfceo" 'sentences". 

Alternative view: the concept Of recursion is 1oo important to be eliminated 
from LOGO- flecuTSive programs are allowed. Educationally, the more examples 
Cf recursion available, the easier it is lo understand. Hence, lists should be 
allowed. 

Compulational power is not always in cOn'Uct with educational simplicity. In 
addition lo the standard list operations oF FIRST iCAR) and JtyTFIRST (C0*f), LOGO 
provides M5T end BUTLAST. Furthermore, all four Of these Operations work On words 
is- well as sentences. The fad that wed manpulalion is more cosily- than list 
manipulation for LIS 3 , or that taking the MSFof a list Is more- expensive Itian computing 
its FfRST is nO't 0' interest to the beginner. The natural symmetry of having all of these 
Operations is to be preferred- 
Alternative view; LOGO introduces two data types - words af*d sentences. 



ftlfeirncrs brlwrni LOGO and LISP Section 2,1 
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There is both an empty word and an empty sentence. LISP's world is easier to 
understand. There I* only one Type ol d*ta, s-esrpres.siof's. Primitives Fikc Crtn" 
are list Operations only; they do mot operate on ward* by manip'j at ng the 
word 1 * print name, is LOGO'* FIRST oWs. 

Repeatedly SuTFJflSrinj • sontenta in LOGO always terminates in ihe empty list. 
In LISP, wilh its more general list structure buil! Irom "dotted pairs" and CON&ng, Ihis is 
not always so. The result is the possibility of "slip-through" bugs tor EMPTYP endlests 
qf recur $i*a procedures. Thus, LOGO eliminates, a common source □! error without 
signiFicentFy limiting computational power. 

Alternate* yjew; Allowing, *n itom tc be the CDS ol ir> s-6Tprest»gn 
sometimes allows (or economy of storage. Also, the symmetry of C/Tfi and CDF 
in LISP make the data slrudure easier td explain, a though they are symmetric: 
as Lisl operations only for Ihe particular representation oi l»sls usrd in U5P. 

Rijfd progr am form 

LISP allows programs to be lists ol any form. Editing and debvaejia tonsequenlly 
become awkward due to the diF'ic-jlty in naming parts of the program. LOGO simpliftes 
program slrutture by requiring that a program be a series or numbered lines. The 
iotefciQns ol bugs and interred edils are then far easier 1o describe. 

Criticism: LOGO violates this assumption by allowing (he 'user 10 ere ale lines of 
unlimited complexity. 11 would be preferable to limit a line to a single top level 
Call. This does not prohibit nesting, » Fundamental idea in C0mpu1?tiori, tVt il 
does prohibit defeating "he entire poinl of line numbers with such code asi 

>J( FD IM RT W FD iCfl fiT W . . . 

An alternative scheme might be to adopt ■ TOT* like convention. Lines are 
identified by offsets from user-defined location symbols. This has ?he 
advantage Of encouf aging Ihe use of mnemonic names f Of portions ol (tie user's 
program, rather than line numbers, wh*th have iuj mnemonic value, while 
retaining Ihe virtue of hiving a name For every part of the program. The user 
would not have 10 renumber hnes il he wanted to iniert more lines, between 
rwo lines ol code than the diFlerence between Iheir line numbers. 

Integer Arithmetic 

The initial CLQGQ world limits Ihe user to integer arithmetic. The ralionale behind 
thtt is lo avoid The eomple-mty of declmtl fractions, Th* Is clearly a sin* pi ideation whose 
value depends on the background or the students. 

Criticism? 4v*n tor alemant try school children, this simplification may cause 
confusion. Most beginners are troubled with 

1 


2 

Proponent j Of flted point arithmetic mijht reply thai this is nd.wOrse 1han 
I 

— - .9M999 
1 



DilEanncei batwnn HMO and LISP Section 3.1 



LISP LOGO HCMD hue 4 June 1?, 13?4 



However, a decimal printer can be clev»* |r> perlwming roundpff- 

Oilier alternatives ire ft) limil arithmetic to rational number?, or (p use lha 
following LISP tflnv»n('9n; Number* jir-e flted point unless ending in a decimal 
fraction, Operation* only reign n lined point \i both operands ate Jixed point. 

AnQlher virtue ot LlSP it Ihtt Fked pflmt numb*" can be infinitely large. 
Arhi|rary limit aliens duo to 1he Fi"''e sire cl I he computer's word do no' UKisi to cOnlusfl 
Itie beginner. 

Condilionals 

LOQO allows Itie following lypc o< brinttang; 

>IQ TE ST ^pcerfiMif 1 
>iS J fTffl/ff .... 

TEST sets * flag which subsequent fFTRt,f¥?s and FFFAISE 1 * access. This avoids the 
necessity of Itie entire conditional appearing on a single line of the procedure. The 
student has espticit names in lha form of tine numbers For each brancK 

Criticism; This prevent nesting of conditio? als. A second conditional wipes Out 
the results ol lha first. In LUQGQ, the Flag set by TEST is dimply a USP 
variable. Since il i-s global. TEST* m sub-prOcedures can alfeet IFTRVE't. In 
tho super -procedure. This introduces a non-local nature to control structure. 

LOGO'S lack of canned loops such as DO and H/IFCAR can be criticized as 
encouraging, bad programming practice, such is encesnive use of CO. Tnis obscures the 
logical structure oF programs. A^so, it may be significantly confusing to Ihs beginner, ind 
Ihrc suurea of many bugs. A child might understand quite welt a control structure concepl 

MKe "do Itli? part P' the program ihrrjp fimtS~, Or "dO 1his. part Of 1hp prCigr^m Ipr tath 

element ol the list", but may be unable to open-code that control structure <n terms of 
pumps and conditionals,, LOGO program*, can-'t be "pretty printed" to re«eai (heir togieal 
structure as can programs written in LISP or a block structured language. 



g.g Naturalness 

Mnemonic Names 

An Obvious virtu* ol any computer language ■* |o use proeedu-e names whoee 
English, meaning sujges-ts I heir purpose- Consequently, USP's primitives C/Jfl and CDJt 
are renamed FIRST and Hf.TFfRF.T. 

Nele; Everyone remembers- how un-mnempnic C/JR and CDF ire. However, 
mosl LISP primitives are named aFler I heir English counterparts. 

djOGO syntax alleys lha use 01 ca*tain 1no*Ee words", words which appear in th# 
user's code, bul have no eflect beyond making Ihe code read mora like English sentences. 
For example, In the lolto* E ng line? pf LOGO <&to, (he ASD, 0H r THZK and TO are 
permitted but serve no coTou'alio^al purpose. They do nOl dea-gnate procedures* as is 
the usual case with words not beginning with a colon. 
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'BOH/ <prpiEcH[* J> fl.¥E <pnJcca4* r» 
'GiTfJltf *j*n-a , «<tie J> OR <p™JicH^ i> 

?CT? TO . . . . . 

However, as lha studerl gains mOre insight into LOGO, noise word* h*c-ome a 
burden. They complicate th* ta=h of the p-a'ser, preventing lha student 'r-om lee'iiig that 
he really Uri-ders1*nds the language. Most of the noise wO'dt hive been eliminated in 
both PDPI1 LQQQ and LISP UX3& [LLOGO will tolerate THfl.V in condilicnals, and TO in 
transfers, however, because the^ -are so commonly used.] + 

Washing English vocabulary 16 computer functions *»n be difficult. English words 
rarely have a si^le ir^anin^, Following are same example! where CLOGO may havn made 
th* Wrong chgice- 

1. CLQGQ uses fS instead ol EQb'&f' Fur its equal 1 ty predicate. The rationale is thai 15 
will be more- familiar to a nnn-mrihematkil beginner, How»V*r, the omnipresent nature 
af this English verb results in such LOGO code as: 

tFESF iS iTttIS.NVMBER CRRATFRP :THATJWMBKR 

thuSj it mighl be belter 1or LOGO to uift EOUflL 

2. Another example where LOGO r*»y have chosen lhe wring word is m defining 
procedures. This is done viae 

?TO PBOCEK/ffE.^tf^ TlffPJJtl JNPVTl . . . 

Th» Eftglteh ward to" can imply execution, For example, *he is to run his program". A, 
belter choice would be Velind". 

Parsing 

LISP tvoids the necessity or parsi-ng through the us* of parentheses. This might 
be considered well worth emulating in LOGO ttjt its etpltnatnry simplicity. However, 
simplicity must be contrasted with naturalness. A beginner is used to using English 
where verbs end TOd' tiers »f« connected by grammar, context and irearnng rjther thin 
ejcp-tkit parenthesising. This naturalness can bt preserved for procedures that take i 
fixed number or inputs, This a' lows such lines Ot code to be underwood by anyone 
without any special progf ST-fng *-Owled&e 

IFQf&FARD 160 RIGHT 90 

Thus, a beginner can express himself with «0 t%U* burden ol parenthesizing when his 
programs are still very simple. 

Parsing can be used to permit Infix nora-lion. Again il is simpler to demand that all 
functional calls be m proFiif notation. However, a beginner I* far ™re famHar with 
fOHWARFi iStDK*tV than with IFQHVFAM) (SVU St BE WJJL 

Eventually, as One's code becomes more complex, parentheses become a 
simpUfytng tool. One does not hi^e to guess- *w* lhe pa*ser will wOrh. LLOGO allows 
thrs. If desired, parentheses are permitted and interpreted in the standard way. 
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Criticism: LOGO complicates its PBT^ing al&pnlhm in several ways, mskihg it 
difficult to evola n to a student. For example, Ihe language does no1 insist that 
all (jnmpfeivu-s lek# * fixed rtumhflr □! Input). In iDne Liiai such as the til la 
lines or dafiriliuns,, thi-s is reasonable. On the Other hand. It h somewhat 
confuting to limit such primitives IS SVM to only 2 Input* if not pirentheii»d 
but my number of inpuls il pireflthesiied- EquiHy bid if (he fict Itipt 
primitives (ike !1 LOGO'S PKlfiTOUT for printing definitions do not evaluate 
t heir inputs. It would be more consista-l lor 

■fpRt NTOUT 'PROCRAH* 

to b* required 

3J Disparity 

Prcg r arn Versut [lata 

Both programs end dtti if* information structures. The difference twlween the- 
two it solely a matter ol tree. LISP -prefer vat this elegant view by allowing program* to 
be passed as inpul and, indeed, to even redeline themselves. This power, for atl its 
simplicity, e*n confuse the beg inner. For Ihe novice, the deference bet**f-n defining ami 
running, a procedure is unclear. LOGO provides clarification by forcing i complete 
distinction between the practises- ol defining and ol evaluation 

Criticism: LOGO Cobles this idea, A program ttn be executed inside i 
definition if not preceded by a line number, Thi-s is a m slake. The typical case 
is tor *he user lo 'ir* i--le"-:ad to lypa Ihe line number. In its-wisMul desire 
for rrtore computational power, LGGO hat forgolten its episiemQlOgical 
foundations. 

Homonyms 

LISP has Ihe ability for a word to be the name of both a procedure and a 
variable. The position el the word in ■ list then determines how It Is used. Hjmonyms, 
rxiwpvpr, can be c-Onfusing. htov shOuW a word which is both a procedure and a variable 
be treated when it is Ihe first etemenl in e M-eC? The choice is arbitrary. 

LOQO prevents 5,vch homonyms. Wards evaluate as variables only when preceded 
by V 

, . L X , . causes X to evaluate as a procedure call. 
. , , :X , , returns the value of trie variable *. 

thus, LOGO and LISP share the power of allowing; any string; ol letters, rp be mrhcr * 
pr&cedure or a variable name. But LOGO insists on an unambiguous "local" distinction, 
independent: ol position, between these two uses. 

Another example ot the clever ways LlSP lakes advantage n1 homonyms is StL 
LISP uses this word to name both the empty list and the logical truth value FAtJlR. This 
can result in more economical procedures. The convenience, r<n#evpr, has no conceptual 
basis. Hence, it can cOniuse the user who does not yet understand either list 
manipulation Or logical analysis well This is similar to the situation in APL, where the 
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logical canslan^fi At* the intcj^l-S fcfid 1, »hd tOhdi|re.n»ls if« J£opmpli$hW !?y rMjitrt^C^til 

m^niovilstifl" II t*n 1«d lo Cbs-curi r.g ihe purpose 0' • given p«ece 4' cede. 

tin* wie^led koul 

L1£P evaluate? *!) t^prtStten whein pjrpnth* W5 b*lanr;r. Thut .t ganrtQt, r;*Uh 
error? caused by typing toe many righl parentheses. LOGO *-aih tor h car-riage return. 
Hence, it is £ap.*hlfi of fetag.hiiirt4 thii problem. Fgr 1 hfcr frwr e, a t«er (Jin write several 
calls On a fine. Execution is delayed unlil a carriage return is typed. This h*s tne wirlue 
Of S«pM-lHrtg the tasks Of t&rrpipg $raminjl»c.al c*prBS5i0ns frOii eitedJ-tir^ programs. 
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Section i, QvfrvliFwr erf tje Tiwplein<n^ttMi 



LISP LOGO i? designed %o that the user need never know that he is communicating 
with other than a standard LOGO However,. iF desired, h» c»n insert p*renlh*siz*d LISP 
code anywhere m Ws LOGO program. 

LISP LOGO Is basically a compiler. It converts 10GO input to LISP progrww. The 
result Is that running most procedures takes lei* time since the code need not be 
repeatedly interned and parsed. 

The following pages provide an overview Of Ihe mi jar parts ol the system. 
These are ils reader, parser, evjluitor,. print*', and error handler, Mc-rrj detailed 
explanations of these will Fallow in liler sections at this memo. Far 'mplemenlition 
details, LlSP LOGO it available in WBll-cemtr*nt*d interpretive tods. 

Code for the LOGO display turtle is discussed in Sedion- 15, 3rd cad* f^r I he 
rr.jr.it; h&x in Ser.t>Qn 16. The TOGO project" -s concerned with wore than Ihe 
development at a computer language. OF ma^Or interest re (he design ol various 
computer-driven devices which preside * "ch problem solving environment for the 
student, However, special purpose primitives for driving these devices are independent of 
LOGO versus LIEF issues and must be added individually. A LlSP-based implementation 
does have one special Virtue, For thc.e devices like the music bo* wrji^h *rp driven by 
ASCII characters, the primitives can be written in LISP Or LOGO and thtan compiled. II is 
no| nrcrss^ry to create cod* at trW machine leveL 



3,1 Reader 

The LOGO reader is basically a line -oriented LISP reader. It returns a list ol 
atoms read between carriage returns. The Fundamental tasks at inter- ing atoms and 
building |i$,| structure are handled few LtSP- Conflicts in character Syritw and iderilillert 
between LISP and LQGQ present the Onty subtleties. 

Cerlaiin characters such as The infix Operators +, -, *, end f do not require spaces 
to be set off as atoms. This is equivalent lo being a 'single character object" in LISP. 
Other characters such as "." In dotted pairs are Special in I JSP but not in LODfj, The 
solution to these com licit is lOund in usinj srpanle "re*dtable ,-, s for LOGO and LISP. 

Conflicts in names tfscy occur, The LOGO user has veeef; to all the Ordinary LISP 
procedures, bu1 must be prevented From accessing LISP procedures which are internal to 
LLOGO. This is accomplished by using two "obarrafys*. When the user types in mti 
identifier with the sarrw name as an internal procedure, he accesses * different atom. 

MACLISF allows any number oF separate 'readtabie^ and "obarray's. This 
permits multiple worlds - PLANNER, CONMVER; USP H LOGO - to eo-eiist wilh no conflict. 
Switching worrds it eomputattonalFy f*sl. All 1h?r 1? nocoss^ry is 10 rebind the 
REABTABLE and {MARHAY variables to the desired world. On the other hand, the 
naive user is protected completely from other environments and need not even lunOw el 
their existence. 
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S.2 Parser 

The parser converls * LOGO lm* lo litt-ttrut+ur*d form. This requires (hit 
informal ion on the number ol inputs used by a procedure be- available. Inserting 
parentheses is a trivial cOmpul atiO" For procedures with a fixed number Ot inpuls. 
However, complexities are introduced inlo the 1000 parser by: 

1. Hiving inFi* as well as p*efrn operators. 

2. Changing the number of inpu1s depending upon whether 1he user embedded the form 
in parentheses tSUM. SENTENCE. ...). 

3. Primitives like TO that do not parsi thasr input, 

4- Homonyms: Functions whkh have Iht sam name in u^P gnd LOGO, but have dilferent 
meanings. These are handled by having lhe parser detect 1he names o', LQQQ primitives 
which tonflicl with Ll&P. and convert Ihcm to Function? with diflerenl names that do nol 
conflkl. 

This makes the parser the mosl complicated pari oF the simulation. 

Parsing information is stored on th# property list ol i function. Th* maror sub- 
procedures are concerned with preliv, infix, and user-lyped parentheses. Special 
primitives are parsed by storing a procedure as Ire parsing property. 



1,1 EralMtiw 

The bask LOGO functions that do lhe user's computation - ije. the anthmehc, list,, 
«tkJ logical primitives - ?rp t k c- s mpbnsl part OF the sirnulahon, These- functions all OCCUr 
in LISP, usually in a somewhat more general Form. Hence,. Ehrs part of lhe implement alien 
It litlle mora th*H renaming. For many primitives, LLOGO provides mQrr? argument type 
checking and informative erro* messages t h an a r e supplied by their U5P counterparts. 

Parsed code is executed directly by Iht LISP svaJmtor,. Indeed, a vser-delined 
program in parsed form is simply ■ LISP PROG- The line numbers are tags in the FROG- 



$A Printing 

LQQQ procedures co-Jd be represented as lists Of unparsed lines internally. In 
IhiB case, a line rrusL be interned and parsed each time it is run, s4o*evfjr, the problem* 
ol printing thn ttetinihon and ediling a function are simplilied. The internal format is 
identical la the Formal in which the user originally typed the expression. 

An alternative solution is to represent LOGO programs in parsed, i.e. LISP lOrm„ A 
LOGO program Internally is a LISP program, This maximizes run time speed and simplifies 
building program underslanders. It has the disadvantage of complicating the parser and 
the printer. 

I, The parser must handle functions that have not yet been detined. This can be 
accomplished, however, by rr^rrling to 1he solution ol parsing at rim time those lines 
which contain unknown lunctions. This run-tune parsing can after lhe program's de1im|ion 
as well so it Only need Occur onto. 
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2. Mfilir*t definition »nrj ndiFing lints requires an inverse parser 3r "unparser*" Which 
returns the LISP-iFied code Id Ms otigiml form. This k possible providing, there is no 
information lost in parsing. Suth is the CaS* =f the parser makes special provision for 
dislinguishing user-lyped parentheses From parser-generated parentheses. One way to 
Accomplish this is by bBginnifrg US«?r -lists with * dq-nOthlnj fm>cl*in USER-PARK\\ 
defined as: 

(DEFUN USER-MREN (X) X) 

3. Editing title lines is made more complc*, The n-dilor nmst reparse the lines fll super - 
procedures in which the edited Function Appears. This can he accomplished by 
maintaining a super-pretedure tret, all hpufch LLOGQdees -v>t cyri-enHj- do this, 

These camplicaliors nan be avoided by storing both representations of the 
procedure. This is in exceltonl example of a space versus complexity trade-off. LlSP 
LOGO currently does not store both representatlons. 



j.it Error Amlyala 

Since LOGO is a language which is designed 1o be used by beginning, 
programmers, it is important Co provide inlorrnalrve error messages. Consequenlly, all 
LOGO primitives do extensive lype checking on their inputs. LLQGQ will try 1p print oul 
the r-orm which cairsed the- err&T, *nd give the lrr» number i1 the error occurred inside a 
procedure. Alter a simple mistyping error which can be detected by the parser, (he user 
is given an immediate OppOrlunity to c&rrecl Ihe l-ne. for run t'me errors, he is given 
I he option Of Causing breakpoints. Facilities for exploring Ihs slack from inside a 
breakpoint loop are available. Since iQGQ procedures are represenled internally as LI$P 
procedures, Ihe standard llSP TRACE package can be used. 

These labilities are implemented using LISP error interrupt handlers end 
EVAf.FK/lMt'. 11 1he sophisticated user wishes to provide his own errpr handlers, he can 
■ee*ss the LISP facilities direclly. 
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itctton 4, Perform nice 

4.1 gjs 

!':." 20 Sucks {IDE*. 36 hit words} 

LLQGQ (compiled} 7 r>n»ry program 

5 Lis! structure 
2 Number*, Atomic symbols, etc. 

Total space 40 

These figure* do not include space for user programs, or foading (he display 
turtle, musk, or CERWLA\D pKkffs.es. Between 5 and 3 OK beyond the amount of storage 
ment«aned ahove wQirld provide a reasonable amount 01 workspace 1-or user programs 
and d-a l-a; this would correspond roughly to programs of perhaps a lew p*£ea, In the 
current MACLISP, storage expands as needed, ULOGO takes advantage d( 1his Feature ~ If 
programs grow beyond a certain size the Use-r i-s toted whether no- wishes the allocation 
lo be increased. Storage «s expanded aulomalically on loadng speciaF packages such as 
I he display turtle. Of the L4 blocks which comprise the UOGQ systnm, all bul 3 arc pure, 
and! car be sh»rnrf among users. 



4.2 ■Cum pu[*lioii Time 

For most processing, LLOGO enjoys a seeed-up over CLOGO anil ] ItOGO duo to 
the fact Iha1 parsing and interning, occur ariy once at deFine lime. Further, LLQGQ makes 
it possible to compile LOGO source programs Info machine code using the MACLISP 
compiler for increased efficiency [See Section 91 Workspaces can be slored on the 
disk, in internal LISP format. [See Section 10,1] Consequently, re-reading Files has no 
overhead. CLOGO has an advanlage, however, in manipulating words, as its internal data 
Structure r$ string r«th*r then lis! Oriented, 



4.S U« 

Atmpst all of the primitives of ClOGO and 11 LOGO, (including, the musk ban, 
display turtle for the POP-6 and GT40) ere 'molemenled. Hence, LISP IQGQ is capable C* 
readme,, parsing er*d running Wsl Mm sav*d under ClOGO or ] LlOGO [perhaps 
necessitating minor modi fical ion], 

ft can also be used real-time by an individual familiar only with LOGO; no 
knowledge ol LISP is required, On the other hand, all of LISP'S licililtes are available. 
Programs can be wrilten in LISP, w in machine language using LAP, and can be made 
callable from LQQQ. The special packages for the display turtle, music box and 
GEfiMLAND can also be used from en ordinary LISP, Some olher facilities of LLOGQ, such 
as ihe breakpoint and stack manipulating function, are also available lor use in LISP. 
LtSP users can take advantage Of these facilities without interaction with LOGO vmpiy by 
loading the appropriate files of LISP functions, 
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4.4AvtttibJlitj 

Th* iipplBirentjlion is wnttiri tCwnplfltaty in interpraliva c<^de. It rur*s tCfupiled 
under the MACLISP currently in uie at lt» Artificial Inlellrgenca Laboratory. LtOQO has 
tho bton implifinBrtfod on itsnrj»rd DEC POP-tO's ur*d*r th* TEftBO and TENEJt ■fyttarns. 
■nd on MULTICS. These implementations are discussed in faction 13 and Seel inn 12 ol 
this rramo. 
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Section 5, Getting Started 



In the following sedio^l, we *iH ga ihto mOre tfe+ail tOnsemirit the 
implementation ol IE£P UOQO, and provide soma praclical information for using it. Wn will 
nol at1empt la provide Ihe reader with an introduction lo the LOGO lan^u^R^ reveal 
excellent sources tor lhi-s already exist,, such as It* LQGQ Primer,, and the I L LOGO User's 
matujal [LOGO TemO ?\ We wll assume 1 hat the raider his read 1hese, a' is akeaJy 
familiar with ClOGO Of 131000, In* other irnplemenlalioni of the LOGO lavage available 
al tha Al lab. Instead, we will concentrate on pointing duI di-fie-r^nees between LtOGO and 
other irrp'e-rentiitiDr^ of LOGO, and iJr^.-rlbinj I natures unique la Our implementation, ll 'S 
net fwecssary TO know LISP to understand mOsI ot what follows, although some 
knowledge or USF would be hel^M In gaining l^igM n>o the implementation. For more 
Information on LlSPp see the MACLISP Reference Manual by Dave Moon, and 1he Interim 
LISP User's Guide [Al memo 190 J 



rotational contentions: Throughout l>*s memo, USER TTPEIN and LOCO CODE 

WlJf AppNLf ih a fdni likr ibii. SYSTEM 7TPE9UT nill appear In a innl likr Hii?. Con|fOf 
Char k tars are derroled by a followed by the character. You type a control character by 
folding dawri t v ie LOn1rG ! ke-y Whilr yOu art typing the character, 1 means escape &t 
altmorfie, not dollar -sign, except where otherwise noted. Angle brackets K * mean 
something ot the appropriate 1ype suggested within the brackets; for instance, if your 
user name is HENF?lr, '-user name:* means your user name, e.g. HENRY. E*e*pt foT control 
characters, which usually lake immediate etFect, and except where Otherwise nolad, end 
all lines pf typein with a carriage return, 

Th« following procedure, is inlendad 10 help very naive users oF ITS to gel logged 
in, end to obtain LISP LOGO. See Al memo JL&\ Ho* To 3»t On I he System, tor i*Ofe 
details. 

1. Find a free consols. A console which is free show*, 

t 

Al ITS <vcriiim> EUNSuLE r-iiiimbcr> FREE, *limc>, 



2. A comolft w+iich is fre* understandE Only One COmnind. tt it aZ. The computer will 
respond with the following messages: 

Al ITS <vwittm>. DDfT <™-t«m>. 

<pamWr> USOTS, 

■^newa> 

3. Wrien il slops printing, IOg<n as lollOwsi type 

zlJ)GI,\ <uuf nama> 
if th«rt tre any rots* age* for you, 
--WAIL-- 
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will be printed, Yqu tan type ■ space Id receive it or my other character to postpone il. 
A 4 will be typed at the ertd. 



4. How you have completed logging in to the Al system. ULQGO is a subsystem oF At ITS. 
To not LLOGO started, 



6. Decide which version ol LISP LOGO you want, Choose IrOm: 

LLOGO - Standard version Of DSP LOGO, Vocabulary is. ccmoalible with CLOGO. 

11LOD0 - A version which uses a vocabulary which is compatible with POP] I LOGO, 5»a 
Section II For da tails. 

NlLOGO -The very latest version oF LISP LOGO. This is enperimenlal, so we make no 
promises. 

When you decide which ynu wanl, lype 

rename- of program* 

for example, :LL0CCJ - 



6, Then LLOGO will pnnt oul som* Initlil message*, Includlr^g its version number and 
LISP's end will asK you some questions. 

DO TDU WANT TO USE THE DISPLAY TURTLE* 

If you wanl lo define and edit a procedure which contains turlkt display command!, you 
should answer VfS lo I his question, II is not necessary |hal you have the 340 display 
scope, cr the GT40 display, to do just deFlrnnj tndJ editing. You can even run the 
procedure il you do nOl mind not being able 10 see what 1he procedure does See Section 
15 fOf more information. 

BERHLAWO? 

If you want to play with GERMLAND, the display turtf* for character displays such as 
OATAPCXNT termiisls, answer FfiS. This has a prompter which will ru-n some 
demonstrations and provide help it you need il. Again, if you intend lo define or #dH 
procedures designed Id run m GERMlANO, you musl answer YKS. See Seel ion 14. 

KU5!C KM? 

M you wanl lo u*fr LOGO music bo* pmmilivcs, ar*swer YES. This will inquire Further,, as to 

which music box,, etc. See Section It. In case yDU have answered YES to any of these 
questions you have to wait for a while, because il takes =omt time (0 load in the files, ir 
you want to interrupt loading in lype a\ , not f<£. If you have 3 file named U/K20 
(IMTi on your directory or there is a Tile named <aier nmn^ .Lt/)GO. on the (fNTT) 
directory, LLOGO will read it as an initialualnon File, ear-ruling LOGO code contained 
therein, When all this is finished, LLOGO will indicate its readiness wilh 
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LLOGD LISTENING 

? 

?. If yflu find y&ursilf in t*» u^foHurtate ulua'sOn ol nee^ng a bug in L1EjP LQQQ, you 
iniy r*pcrt il by using tht function BUG- The Input 1* BL'C should be a m«Btaj* 
dtStf ibing the difficulty, encloiad in dollar signs. For example, 

THE TURTLE ESCAPED FROM THE 

DISPLfSY SCREEN . . , 

I 

iTMANK YOU. 

& Vom ttn lo&oul when you art* finished by lypina COODHYS I* LOGO- Th* tormina! 
should Ihen ssy, 

AND A PLEASANT DnY TO YQU! 

Al ITS ---hrct^nm-- CONSOLE *.nmii ! b«> FREE <llmt> 

9. Have fum! 
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3ectipn G. Parsing LOCO 



This, section will discusa i few at the More carnpte* issues in pars ng LOGO mtD 
LI"SP, and ditcuss how they are hunjlod by LLOCO. USP <s trivial to bars*, a; ift synta* 
is totally unambiguous. The application oF a Function tn ils iripul e. always happens m 
prefix notation, and the precis* syntactic ssctenj of a i&rm is alway* cltarly delineated by 
parentheses. LQQQ syntax affords the, beginning programmer same convenances. Over 
LISP synlasc h while retaining much of the expressive power OF LISP. Parentheses can be 
omitted s-urfoimding e-very form,, and the (tiara customary infix notation far arithmetic 
expra-ssrOns can bo arbitrarily intermingled with prefix notation. These convenient** are- 
bough! at (ha cwl of complicating, Ihe parser, and introducing soma cases where 
ambiguity results raga'ding the user's intent for some of Ihe language's syntactic 
construct. 



fcl Infix Exprwitons 

LLOGO allows infix n&tatiOn to be Used as well as prefix luntNont in arithmetic 
expressions. Most LOGO *fi|hmetic Function! wsts- in both pr-efii and inti* flavor*, and 
the user is Free to use whichever he desires. 

fPRfST tet*:A»SUU FfRST :* IYIFFERKNCF £*l? 2 
■f. th* tamer ji-5 

tPKiP/T (TMBS i 4MEXPT Ji ((FIRST tXWTMES rC J7>-i» 

LLOQO observes, the Lrsual precedence and JS=oti*1ivity OF arithmetic operatort, 

Note that a .complication ol the LOGO syntax It thai all functions, no! putt infix 
operators, are required to have precedence levels. Is 

*FTR$T -A * J7 

the time as 

?TIMJ?5fFJffSr;^ !7 &r *r7KST fT/WEff ;d U) T 

The. tiluation 15 Fwlhcr complicated by the Usee's probable expectation that Iunc!»0n5 
which manipulate logical values have Iciwer precedence then comparison operators like < t 
> and - So, 

?TEST NUMBER < :PI 

It lahen So mean, 

fTRST (LFSSP ttWHIlKK :PIJ and no! ?LES$P (TEST :MJMBEM :Pt 
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CLQQO gives alt arithmelic nperatgrs Ihe ljfne precedence on the ground* (h*t 
precedence would be difFicutt to explain deafly lo children. However, this has the 
drawback of deviating from the customary mathem*tic*l <gnventiq-rt Since tN» motivation 
for in1 reducing mlix notation into LOGO s-ynta* is so thai arithmetic e*pres-s>ons can be 
writi-en in He in^i* form in common use, ILOCO h** been do^igrte^ f & :>h"y f"-r ij-um 1 
precedence conventions. 

LLQGQ- tries to please everybody. If you feel lh»| the precedence Scheme which 
has been implemented does not agree wilh your iniuition, you are free Id redefine the 
precedence- levels as yog wish. LLODO *1sq provides the capability of defining new InMx 
operators-. 

The initial default precedences are ice Hie a' 1o those o1 LI LOGO and are as 

follows: 

700: a feKpOnentiatiOnJ 

600; * - [prefi-K] 

WO:* s\ 

400: * - finfU] 

300: [default precedence for system and user (unction*) 

200: *> - 

100: IF NOT ROTH EITHER fl.VD 0JT TEST 

S& _[\tAK£} 

In'Uelly, Operators ol level; SO and 700 are right associative, and the rest are left 
associative, which is the deiaull. Logical functions shautd have precedence lower than 
comparison Operators, so iF the user de^nes a logical function he should set the 
precedence himself, other wis.* it will receive the default precedence. The user can 
charge 1hing.s by using the following. Functions: 

PRECEDENCE <op> 

Returns the precedence level of <op>. 
PRECEDENCE <aji> <Uv*l> 

Sets ^op^'s precedence level lo |he specified ^levei*, which may either be a 

number, or anolher operator, which means that <PpJ L is to be given the same precedence 
•5 thai operator, 

PftECEtiRNCE Nil <i«W> 

Sets the delault precedence lor functions to ^level*. AM <jnc1iQris which are not 
in the above lis-1 ol mtk I unc Hems, or have nqt been as-ji^ned • precedence by the user, 
receive the default precedence. 

ASSOCIATE <namb*r> <iohich-tixiy> + 

Declares that all 'uncticn? ol precedence level ^number* wilt etsociale *wNch- 
wiy>, which is either "LEFT nr 'RIGHT. 

INFIX <**p> <1*imI* 
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Da Fines ^op> (5 be tn mlix Operator of precedence <1aval>. Specilylng • 
precedence it optional. 

Forces aH infix operators lo lhe same precedence level [this will be higher trun 
the) d*l*ult precedence]. Makes LISP LOGO look like CLDGQ [well, ilmost...} 

■JNFIX 

Ttiis vamble contains 1 list df all current infix operators. Look, but don'l touck 
Use IftFIX 1o add new n^ia cperalcrs. 



$.2 Minus Sign 

There is some ambiguity in |he handling ot minus Ehjn. Far example, consider 

If the minus sign is interpreted as a" infix difference operator, this will resuM in a lisl Df 
one element. If the minus sigi it interpreted as prefrx regal ion. *l will result in a list qI 
two elements- GLOGO uses lhe spaces in 1he line Id disambiguate this case. If there is a 
space between the minus sign and the rfl, «t is interpreted as infi*„ Otherwise, il rs 
interpreted as prefer, In 1 1 LOGO, spaces ire not semantically significant except lo deh'mil 
wOrds f so Ihis is interpreted as (SEHTE^CE IDlFFMUftflK 3 :A)i regardless of I he 
Occurrernce o* spaces. LLQGO Ireats minus sign a* does ULOGft One would obtain lhe 
result el lhe other inlerprel alien by using 

^SENTENCE 3 f-zA)} 

The preceding discussion applies only to the parsing of jnlix expressions. So, /-#/ 
Is a list Q.I One- element, a neg alive number, but f- if is a list of two plerrcnti, minus sign 
■nd 4. 

6J HgrnoBvini 

LLGIjO makes all lhe lunctions at LIS? directly accessible to lhe LOGO user, in 
exactly It™ same way «s LOGO primitives. This runs inlo dilflcuHy when ? LISP Function 
■nd * LOGO function have the same nan* but diiferenl jnearongs. These are currently 
handled by the parse*, which converts them into innocuous atoms which do not conflict 
with LISP, and are reconverted upon unpirsjn[. Currently lhe following fundion* ate 
homonyms: 

FRIST, RANDOM, LAST, EtJlT, SAVE [in MULTtCS only) 

When |he user types in one of 1hese< it is converted by the parser to an internal 
represenlahOn consisting of a different fiction name [LOGOPflTW, WGO-LftST 
LOCO-EDIT WCQ-RANDQM Or LOGOS /JV £, as appropriate} Wh*n lhe user requests 
thai the Ime be printed out or edited the uflparser converts it back lo lhe wjy if was 
originally typed In, In the CLOGO-tOmpatible versioi of UQGQ, when iCAHEfttL is set to 
non-PilL the following primitives which caniJict with CLDGQ are also ch-anjecJ by lhe 
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pwwf! ffST it ehi^ed to FFl?iTOt.>T, DISPLAY 1o SMOTD/SFLjir, GET and flIE/lD 

1o tlEADFILE, Bid DO to flt/fY- Winning massages ara ikp printed m these ciws. 

Theft is on* pi Mall h tha currant method nf handling Soniany«nsL sornatimes^ as 
with posing lunclional arguments, the parser 4owb .not gat a charw* to dkj i-ts thin&, afi 
Ihe user may find in umpirpBctBd luralmn called^ APPLY 'PrtfnVT .... calls USF* 

FfflflfT function, not LOGO'*- 

jHt AbbrcvUtlona. 

Abbreviations are accompli Ehsd in LUQGQ by putting. (h# hfm of the luncticm 
which is abbreviated on the property !i*t Ol the abbrevialion as ai FX^P or FEtfPR 
property, as appropriate. Abbreviations are expanded -nto t'-eir Ml fof m o>n paring, and 
are lelt thai way. The user has the capability of creating, his Own- abbreviations by 

#nd fcrrerng 1hem by 

•fKRASS ABBREVIATION *nai**> 

ABBREVIATE evaluates its inputs, but ERAH doesn't. A complete lisNnf of 
abbreviations con be oblBined by dams 

•fPMPfPQVT ABBREVIATIONS 
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fggjflg 7, Defining and Editing Function* 



In LOQOj when the u-ser deFines a procedure us ng Tfi, Or ElftT^ a p'Ocedure he 
has previously deHnad, LOGO enters an "edil mode", »Mr# |rne? beg^nn^ng -with a number 
are inserted into the procedure under modification, LOGO prompts wilh *>" ralher than "?" 
to indicate Ihts. Th« intent ol having a separate mode fflr editing procedures it to stress 
the dk&bnclian between defining procedures and executing 1henv this distinction is not 
strictly maintained; it the line does not begin with a number, the commands ara: executed 
*s they would be ordinarily, with a few exceptions (the war is, prevented Prom doing 
another TO or KBIT for instance]. Occasionally, this leads 10 errors t for ir.slB.nce iT the 
user lergot to type the line number il the beginning of i line InSe-nded for ir^ei'tion. 

The defaull state ot ULOGO it to retain the separation of edit mode- from o+dinery 
mode as in J ] LOGO and CLQGQ. The slightly more sophisticated user, however, mighl lind 
himself in an unnecessary toon of continually typing FD/Hs and EnfCs while working on 
the same procedure. Since lhe lines typed by I he user lor inserlian into a procedure are 
Inserted immediacy whet, the gifif liniihes typing, the- line, RNR do«:; rot cause 
anything, to happen otheT 1han the termination Ol ed't mode. The- system always 
remembers I he name of the last function mentioned ey TO, EDIT, PRWTQVT, etc. is * 
default for these Functions, so when working on a single function, EDIT serves only to 
enler edil rr-ode. The user has ar* option 01 tuning 01F the separate edit TOde by setting 
the variable iEDlTMODE to NIL This will cause lines beginning with * number to be 
inserted into the default procedure at any lime. In this made, il is never necessary to use 
END, end E&JT will onty change the name of the default prote?Me il g^ven en input. 
The prompter will not be changed. 

In LLOQ0, it is not necessary to be in edit mode to use EMTLlftE or EDITTiTLtS 

on e line ot the default procedure, and the editing control characters its available even 
when not In edit mode, 



7. 1 Control Character Editi ng 

LLOQO h*s • control -character line editor similar to Ihose in GLOGQ end II LOGO. 
This, makes il particularly convenient to correct minor typing, error s r by providing, a 
means of recycling portions of the line typed previously, insl^d ol r^qui^nFj retyping of 
the entire line. The editor beeps (rack 01 Iwo lines: an old fine which you are ediling, and 
a new line, which LL0G0 is 1o <■&& as the ne^t line oF input- The old line is always the last 
line you lyped at LLDGO, e^ceot irrmed-alely after a parsing error, when 1he o^Fending 
line will be typed out at you, and it may be edited. You can also set the ot-d Ime yourself 
lo be a line in the current deFault procedure by doing RBlTf.INR *-linr nu.mhrr> r or Irte 
title of a procedure by Calling EDfTTiTLE, Everything you type aFter the prompter, or 
cause to appear using I he control characters, is included in the new line, until you type 
carnage re-t^rn, which terminates editing, for feh.il tine, You W? use parts Ol lhe Old li-ne 
in, constructing the new line by using the foUOwing editor commands: 

aE - Get the net! word from the Ironfe of the old line, end pul it On The end ol lhe new 
irli, 

All ' Put the rest ol the old line at the end 0* the new line, Th« is like doing nFs until 
there is nothing lefl in the Old line. 
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AS ' Delete a word f ram Ihe front of Ihe. old line. 

a!" - Delete i word from (he end of Ihe new line. Like fijbouf, etcepl rubs but i word 
instead of a character. 

LLQGO uses ditisrfj^t t*i?r, c ters 1hm I1L0GI} and CUOQQ do becsvse USP 1IWS 
most ct the control characters for interrupt* and i/o 



7.1? Printin g Fund i on Definition* 

The function PRINTOUT can bi used 1ft Iftfth at definilwns of uset pr&cedU'Cs- tn 
■ddiliftn, il his other npliorw fnr examining |he stete of your LLOGO. Pfl/,¥mbT dftesnT 
avaluete il* Inputs. 

PRINTOUT •■prorr tfiir*-rin itui> / MbrttviatUm POf 

Will- print out the definition of the specilied procedure, ir Ihe name is Dimited, it 
will assume Ihe ImI luncttfin thai wjs denned,, edited, or printed. 

PRINTOUT UNE <*■.««*■> fPQLf 

Prints [jut only Ihe spee L fi*d line In the default procedure. 

PHJJVTXJUT Tf TLB ^rweJsms* f POT/ 

Prints, the jut! the lille ol Ihe ppetfdur* |i*en. H It* ihpufc is Omiited, prints the 
Ml* of Ihs- currenl delauM procedure. This h uselul il you forget which p^ocrduto Is Ihe 
deFiult. 

PRINTOUT TITLES /POTS/ 

Prinls Ihe lilies: of ell Current UMf procedures, fcnOres buried procedures [see 
Section 10. 1J. 

PRINTOUT PROCEDURES fPOPRf 

Prints oul the delinitiont ol all currently delined user procedures, Will ngl print 
the definition? of procedures that ?r« buried [see Section ID. I). 

PRINTOUT NAMES ^JWf/ 

Prints the names and values of all user variables, 
PRINTOUT ALL /POAJ 

Does PRfNTOVT PROCEDURES and PRINTOUT NAMES- 
PRINTOUT SNJfPS 

Prints a list of saved display turtle scenes. Sea Sec-lion 15.11. 
PRINTOUT FILE, PRINTOUT INDEX 
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See Section 10:2. 

pmjvtoejt abbreviations 

Prints i list of all currant abbreviations, and the name's nf the procedures which 
each abbreviates. 

PRtNTOUT PRIM 1TIVES 

J firl^ h c-?np e-le : is'. ^ ? I L-GG0 priniiivei? 

Another uselul cGrimard is IJ iVEPfi/rYT, which causes i Ireting, 5*mi'ar to the 
output of PRINTOUT ALU to *PP«r on the line printer, H take* *n optional input, * 
word to be used as ■ tills to name 1ha lifting generated. 

7,) Erasing 

The to^rnpnd 1 ERASE wlH remove unwanted portions o<f yOw LOGO. The inputs to 
KHtlSK are not eva'"ua1ed. The oplions available are: 

ERASE '■pruttdv.i't, iHirtafcl* «r uup iume> 

Cause the: definition Of the specified Obpecl to vanish. Notes When you define a 
f unci ion utinfi TO, it them to «ee if the** already exists i procedure ol 1he same nam*, 
and i1 -so, i-nquires whelher you want the aid detiniliun f!R/l!)f!d. This is to present you 
from accident ally Overwriting de<initiO*iS &f lunclrtns. 

ERASE PRtHtTWE < primitive iwme> 

Tlhe LLOGO primitive sjiven. is iiipul mill be erased. Vou might use this, far 
ei trample., il you wanted In use a name used by LQQ3 for one of your own lunetiflnSr It 
yOu define a name using TO which cOnMcts with a LOGO prirnilive, il will inquire if ygu 
wlnt the rfcdrnt^Ort of the primitive to be erased. 

ERASE USE <tiumi>c r > fERLj 

Erases line ^number> of the default procedure. 
ERASE NAMES fERNf 

unbinds all user variables. 

ERASE PROCEDURES fERPf 

Erases all interpretive, user lunclipnj, Dge 5 ng^ dfect compiled Or buried 
procedures, 

ERASE COMPILED 

Erases all compiled user lunttiont. 
ERASE /ILL fERAf 
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Ukc doktj ERASE PEOCEM/EES. ER/ISE GOJIf F/LED end ERASE . l VflWE5. 

EHflSE dRBKEyW/fliV «oihwHlHNf> 

Etkb5 I he abbravialidn given bs input. UTJe& rvdl ■Hoc! Ihe procedure ITihI il 
abbreviates. 

CRUISE FILE <r*i* *r>K* fERf'J 

So* Section 10-2. 

Eft ASE TRACE *jVnrE(cw> fEKTRJ 

Removes rr»c* from ^function*. See Section &£. 



The functions will no tonjtr bo buried. For a discussion on buried procedures, se* 

Section 10.1. 
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Section a, Error Hi ndling arid Debugging 



The philosophy oi the LISP LOGO wtor ha n dl|fg system is 10 1ry to bn is 
Icrfiving is possible; the system will jive you an acipartunily Fp recover tram almost #ny 
lype of error [except a bug in LLOGO^ There are Two types ot errors which can Occur: 



S.I Parsing Errors 

If Tor some reason. LLOGO cannOl parse Ihe Fins you typed [for example, you may 
have typed mismatched pn'-sint^ftLei-J, 1 his CAu^&i. a rja-=ing error. When this happens, 
LLQGQ 1 will print a- message lolling you why 't was unhappy, relype the Of 'ending line al 
yQu, and typfl Fr*c r-Jitaf prompt character. Ypu now have a chance to redeem yoursell 
by correcting the lino -- you may use any of the ediling contra? characters [see Section 
7.1 J. When you are satisfied that the line is correct, type carriage return, and LLOGQ will 

•valuation, using the corrected line in place at the one which was in error. 



fl.g Run Time Error* 

When a run time error Occurs, a message will be printed. If the error occurs 
inside a LOGO user defined function, the message wilF say something lite: 

JlRHOR IN LINE <CHlmberJ OF <pntardiinE> 

fLINE <nuinber> IS : 

;<rr*»n tor error* 

Il trie error occ-ured inside a LOGO prirnilivi, the message will look like: 

jDDULDNT EYnLIMTB *btd hnrP- 

■RECAU3E 

i<reasoti far error* 

where ^bao 'orm> is what LLQGO was trying 10 evaluate when (h* error occurred, 
Usually^ this will give you enough mFOrmahom 10 figure out where the error occurred, 
although *bad Form* is sometimes unirtformitive. Usually, LLQGO will simply re I urn to the 
top level lOPp when such an error occur*. However, 11 yOu SETQ the variable 
:ERRBREAK lo something Other than NIL, [or MAKE •ERRBREAK . . . ] a run time 
error will cause a LOGO break loop to be entered after the mejsa&o Is prmted. Setting 
Ihe variable ;L15FBREAK to non-ArJrl will cause a LiBP style breakpoint to occur when 
an error happens. [Few a rjfttalkd discusS'^n o J srraFoOinls, see below. Section B.3.] 
You can rest/me execution oF yo'., r prog'am Iron* the poinl at which the error occurred^ 
by DfJflrTIWKina with something Fa be used in pi see oF (hr piece fll data which caused 
the error. II Ihe error was an undelinad" limction, you may {jQ,VTTNJ.>'E with (he name of 
a function which has a definition. If Ihe errar was *n unbound variable, CONTINUE wilh 
a vafue lor 1hat variable. If IFie error was a wrong type o1 input Fo a LOI30 primitive, 
(30JV77IVW wilh some ipprop'iate *elue tor an input to trial iuncliQn, etc. Lsual y >t will 
be obvious from 1he context what sort of item is required. ContputaliDn will be resumed 
Irorsn where th* error occurred, with the relumed item substituted For the one which 
caused 1he error, [r^ole: the usual LISP interrupt handler functions enpecl a list pf the 
new item lo be returned, while LLOQCfs eHpecl sJmply the item]. The LISP LOGO rim-time 
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error handling work* by utilising th* LISP irro* interrupt facility. If you don't rjk* ihe 
way LLQQO handler ary oF the error conditions, you are 1i-«-e to design your awn error 
Interrupt handlers, Oither in LISP Or in LOGO. 



8 ,3 B rf a kpotn U 

A powerful debug ajrg, aid is the ability to ejus* breakpoints. Stopping a program 
in the process of being, evaluated altows the user to examine and modify Ms stale, and 
explore Ihe history o( evaluation which lid up to the breakpoint. LISP provides excellent 
facilities -for etoinft this, ineludinj JUlomalit generation of breakpoints when an error 
Occurs. Whenever LIBF starts 10 evaluate a form, it first pushes the Farm on a stack; from 
a bre*fcpQ.inl Oft* can examine [>■* stack to dttermiii* what forms were m 1he process of 
being evaluated, and perform evaluation relslive to « particular stack 1r*me. LISP LOGO 
attempts to make these leatures easily available to the user h from either LISP or LOGO. 
VWs 0ns flf thfSt breakpoint function* ir* *1jO *^«Hljb>* Which C*n run in an Ordinary 
LISP, without the rest ot the LOQQ environment. The following facilities are available 1or 
causing breakpoints: 

WCOHREAK <j*4Jiaje> <«ttdit»n> *rel*irn-wliiif> fMttrtviatim PAVSEf 

The inputs are all Optional, and are not eva'ualed. Unless ^cond.^on* is given and 
evaluates to NfL, UOCQHRRAK causes the user to enter a loop where LOGO commands 
can be typed and: the results printed, This is similar to the lop le vet loop except that fl is 
printed as, a prompter father than *; il is, very much like repeatedly evaluating. PRINT 
HL/rV REQUEST. If ^message 1, is present,, it will be printed! Out upon enlry to the break 
point It also prints, the form in the current stac* frame, which will be the call lo 
fX)COIlRRAK if called explicitly by the user, If the breakpoint happened because of an 
error, 1he initial slack frame will be the One cOntai^ng the 10rm which caused the error. 
LOCOtiHEAH tries wherever possible to print out Ihe current form as LOCO code b*fOr* 
LI enters- a LOCO' break point. However, the current version is not always smart enough 
to distinguish between LISP end LOGO lr»rnes on 1hf stack, so yOu mghl occasionally see 
what looks like internal LISP garbage I here. 14 yau go up far e^sugh, you are sure to find 
the LOOO code, A smarter version cOu?d recfrjnizs the LISP frames andi ignore tNim, Th* 
third inpul is a default value for UQG9RREAK to return if it is OCVTfM/fd. ISee 
description Of GOiVTthVE, below] Caution the breakpoint function* described i<n this 
section use LISFs LATCH and THROW. Unlabeled THRQWb from inside a breakpoint 
loop ere highly discouraged. 

M 

tf control-A is typed at any time, even while a program is running, i1 will cause an 
interrupt and a LOGO break point wilt be entered, 

LtSPHftRAK <m***o.£** <J\f>nJllion> ^ritfLirw value* / Atb. BREAK J 

Tthi« Is like LQCQBREAK, etcepl that 1he toop is a LISP fPflf.VT (RVAL fREtWl' 
loop, This is. especially useFut when debugging a set o1 LlSP luncliOns des gned 1o run in 
LOOO- To access your LOQQ variables and user 1 unctions from mside a LIS 17 break loop, 
prefix them with a sharp sign {"VL LlSP users note: you can interad with this break, 
loop *s with the standard LISP RHEfiK Function, ancept that it is set up lo allow use of 
the stack hacking, fund ions destrrhedi below. M JP is typed, Dr (CONTINi.'Ef invoked, the 
<return va)ue> will be 1he value Of the cell to USPBKEAK. 
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AH 

As in LISP, aJJ typad it any tlm* will interrupt and causa i LISP braakpaml to bo 
entered. , 

FRRRREAK 

H thi% variable is nol fflt^ when a run Irrre error happens t JjfJCfJ H H HA K will be 
called autflamalically. Thre jives you » chance to (ind out wh»t want wtoiji, and recover 
by CO-IVrf JVtj'ITine. wiih a new piece of data lo replace Ihe one lhaL caused Ihe error. II is. 
milialty sat to JV/L 

;MSJWK0K 

Li** rfiflflRlrffAlf,, eseept 1hat if se* 1o SDrr-sthi'-.s other than Sfl^ when an error 
happens. USPffffE^Jt rather (hm l/XJttfrWM wrll be called. Initially stt to Wt 

Tte following functions- can be called From inside • bteakpoinl Id examine and manipulate 
Ihe stack: 

ur 

Moves Ihe breakpoint up ons Frame in 1he stack, printing out the 1orm which was 
about lo be evaluated in |hat Inme, TM wilt be Ihe farm *hich tailed the one which was 
last typed out by any of the functions menlioned in this section. Evalualion now lakes 
place in the now slack 1ramn, This mean; that *li IOC-3^ Jind mpul variables will have trie 
values they did when tha! form was about to be evaluated. However, side effects such es 
assignment of glebal varr^lcs arc nol untftme- Firamrjs *r* numbered for (he user's 
convenience,, from increasing u p lo lop level. 

UP ^rmmtrnf* 

[3aes <rumber> frames up tha stack. Like doing UP* *number> limes, the 
■=niFnber> may be negative. In which case, tha breakpoint is moved down 1ho stack father 
"hi: 1 1 up. 

UP *Mlom> 

Goes up the stack until a call to the function whose name is <atom> -a Found 1 . 

UP "tfcram* *mimbtf> 

Goes up Ihe slack unlil the <number>th call to ^alOm? is found. Searches 
downward for Ihe <numiber y th call to the specified Function II <numhar> is negative. 

WIF.'V <alom> <numrW» 

Like UP. evcepl 1hat i1 proceeds down 1he stack instead of up. Both inputs are 
optional, and defadl « for UP, eiwpt (M <number> default* lo -1 instead d +1, It 
^number* is given it is equivalenl to UP _ f-^na meer* I 

PRlNTi/P <VHam* ^munaar* 
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Accepl? inputs at does UP t but instead OF moving |he breakpoint up The slac* to 
the desired frame, all Uwms between the current one and 1h» One specHiad 'fa prinled 
out. this function i* &aad for gelting i quick vi»w ol the 4lac* in the immediate vkinity ol 
the- breakpoint. The breakpoint rermiiH in the same Irame as before. Th* two inputs are 
optional, and default as for UP- 

PR! ffTDOWfif Wvm* <mi™a«r> 

Lik* PfWVTUPi except thai the inpuls *r* interpreted, n for DOWN rather |h»n 
as for t/P„ thai is, i1 prmls frames going, dawn the slack. 

EXIT *™t*™-»ltL»> 

Causes Ihe current slKk Frame to relurn with the value <return-vai ue*. Thai is, 
the cOmputalion continues, as IF Ihe fCrm in the currant it trim had relumed wilh <return- 
value>. The input is Optional, and defauMs 1o fVfL 

Causes the Irame of the otijint'ly invoked, breakpoint to return wilh the spec Hied 
value, The inpul is oeticwial. Use CfJlSTJIVFJl? to ralurn a new item ol dala front inside #n 
ttfQf breakpoint^ lor instance a new lunction name la use in pi it* of one wh*ch was 
undefined, Note lhat in many s,i1uBtior*s, tor example From a uaer-inwc*ed breahpoinl or 
Irom an error brelkpntnl which expects an item to be relumed as the value of the Form 
which cauted the Brrdr„ if you haven't mewed tha breakpoint a round 1ha s,tsc.k, 
COPfTiWR will be idanlical 10 EXfT- II the inpul lo CQftTiNl'R U omilted. 1he default 
return value specifltd by a third inpul la LiSP BREAK or ifiGQRRKflK will be relumed 
as Ihfr ^*lue ol the breakpoint. II no t«h defaull relurn vb+ub was ji*eA ML will he 
relurned. 



Here's, an example: 
•iMAKE'FlftRRREAK T 



lAssure tOGO break happens! 
NYhen an error occurs! 



ptANGMG A SYSTEK MAKE 

T 

TTfl SCKEWUP :S IDeflne- our tosing procedure.! 

>l IF ^JV-fl THEN OUTPUT MNBUUNV 

>J OUTPUT SCREWtSP :rV-l 



(Count do*n to 0, Ihenf 

taval variable which has no *aK,r? 



^CHEWUPDEftNED 

JSCRtWUP a 

;ERHDH IK LIKE 1 OT SCAEWUP 

i.UNC t IS: IF : M-B THEN DUTPUT :UNBDUNu 

■ UNBOUND IS AN UNBOUND VARIABLE 

;RfiEAKP0INT FRAME 0: MHKNJHD 

fcju Frame is Ihe variable, £>al wasl 

IwOrlunf gnthk when we bombedt 

We can do any command! 

■vL-hi'tt in the breakpaint.1 
El/f IGoinj up a frame. ^UNBOUND 1 . 
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iBREnMPOTNT FRAME 1: OUTPUT ABOUND 

WOWS 

iBRCAKPOINT FJlAME & UNBOUND 

%UP *SCFKJFVP 

iBREAKPutNT FRAHE 4: StREWtfP M-l 

SbN 

1 

WP 'SCRNFVP 2 

■LT.EAHFOiNT FRAME IB; SCPlEWUP £M-1 

3 

HEX IT V $CRHWED 

SCREWED 

r 



!was (ha input Id fK/TPLT! 
Saving down i frame.! 



!we arrive at recursive invocation! 
Iwhere iS had the value 1! 

!lf we rise past £ calk lo 5Cti£IFW»J 

ItPI wes :- ! 

!We decide 10r some reason? 
ntulSCJEHTVPor 2 a ! 
!(0 return the value 'SCREW m. 
land all the prevrQu; invocations ! 
!ol SUJEfFL'P return- with the. value! 
!*SCfiW£D »™.i *e "t afc top icvpi: 
!W»sn1 lhal run?! 



$A_ Wrong Number of Inputs Errors 

Since LOGO syntiir requires th*l the parse* fcnow he* many inputs a luhcltan 
requires, .and LLQQQ pirses your input as you type it in, errors may be generated H you 
change (hfl numbe* of inputs. 4 (urtnlion takes by redo' ninj ^ha lunrjicn, ijr by calling 
EDfTTITLE. Calls Co I hat function which you typed previously are now intorreclly 
parsed, LLOGO w|l| calch most occurrences of this when |ht function \i ollad, and print a 
message like: 

iREPAft5lNl) LING ^number* OF ^pmoriii™> flS: <nrw pirse> 

and atlernpl 10 recover. LLDGO always atlerpsts le reparse a li"€ which caused a wrong 
number of inputs #rror, It is not always possible to win, however, is side effects may 
have occurred before the error was detected. 



S.S Carbide OHeotor Eirwi 

Vers-iortt nf LLOCO running in BIBQP LISP [IfSPs with the capability ol dynamically 
allgcalirm slnraga] have special handlers lor garbage crjl'er.1or interrupts H it decides 
you have used too much slorage space Of a particular 1ypa, or too much stack spree, it 
will stop and pOktsly ask if you wish more to be added If you see Ihese questions 
repeated many limes In a short span of Um wh#le running en© program you should give 
serious consideration to the possibility lhal your program ii doing infinite CfliVSing or 
recurs-ing infinitely. 
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8-6 Tricing 

The stwdard USP rifdCE put^aee m»y be usod tc (race LLQGQ prrmMives Or 
US«r lurKtiOrts. The tracer is rrt1 normally rBsidenl,, but is loaded . in when you first 
reference il. Bee Ihe LISP manual for details on the syntait of ils use and Ihe various 
oplions available. 



87 Inttractign with LISP 

In debug.gi.nB (unctions written in LISP for yse in LLQGG, ■! is Qlren useful to b* 
able 10 swikh back and forth belween LCXSQ and LISP loo levBf loops. You can leave the 
LOGO lop level loop and enter a LISP FRAD-RVAL-PR1NT loop by using the UOGO 
function LISP. From this mode, eneculinE (LOCO) [rsmember to type the parenltiBsss, 
yquV* in USP1] will return to LOGO. Typing COnlroJ-alsign [^a] at any hrr* will cause am 
interrupt and switch worlds* you will *n(ef LISP if you lyped flfl from LOGO, cr wltr 
LOOP il -you typed it from LISP. The LISP loop give* you access tD all nlerral LLOG0 
fUKKtiflnS »n4 global variables, which *r* rOrrrpliy ingMBSslble 'rom LOGO since trwy ere 
on e dilFeren! obarray. LLODO prirrHtrves and system variables are on both obarrsys, so 
they will be accessible from both LISP and LOGO, but LOGO user Junctions and variables 
are On 1he LOGO oh array only. The charaKler sharp sign ['a"] is an dba^rayswiEching 
macros |q access LOGO user functions t«4 variables from (he- LISP loop, pr#'i* 1hsm with a 
sharp sign. 
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Section 9. Compiling LLOCO TJier Procedural 



LISP LOGO compiles a LOGO -source program into LISP and it is stored iMernaliy 
only as LISP code. Since I his is The case, I he LOGO user has The capability ol using The 
LISP compiler directly On his LOGO programs, ami obtain a iubstanlial g,a=n m efficiency., 
Onto his p: - 1 = -i r j^ are Thoroughly debugged. LISP LOGO prOv*des art interface Id 1he LISP 
«*npjil*T wNdh should mav* it urmecetsary for the user to w<Kty about interacting with * 
separata program. 

To compile all o-f the function* turrenlly in the worKipace, the Junction OO.Kf/f.F 
is available. [Th<s does not include buried procedures -- set Section 10. L] II expects 
One word £i input, tO name the file Which Will tOnlam !hs compiled cG.Jr-. Thr nam*; Of 
|h« functions wh>ch are being compiled wilt be printed out. A temporary output tile 
[named .LOGO. OUTPUT] will be written an I he current directory and deleted after the 
cOmpil,i1i<:n b complete. The output file witl hivs as («rsl name thb input to COMPILE, 
and second file name FVISL [In the WULTIC5 imp'emervtatiofi, Ihe temporary file will be 
named Jojoourput and placed in the current directory. The output his w^i appear in the 
working directory, with one name, the input to COMPILE.] Slntt the LISP compiler mutt 
be called up as a separate program, be careful about interrupting Ihe coeipitation before 
rt it finished ffor instance, by aC] a* yOu Will not find yOurittf in LLOGO in^iwre. 

To lOad a compiled lib IrVfo LLOGQt say XEADFILE <»*»> FASL This will load 
ell Ihe compiled functions which were compiled by COMPILE <narnr*, and aiso restore 
fir vahjps Of variables, [hat were defined at That time, The names 61 compiled function 
will he kept on e Hit called <XMPILEV *nd not on CONTENTS For debugging 
purposes, you might want to read in both Ihe compiled ard interpreted definitions of the 
**m* functions, and yOu Can v$* the functions FU/SltOtlHPlLtt> artd 
FLUSH INTERPRETED 1o switch back and forth between compiled and interpreted 
definitiD^t. 

The LOGO COMPILE function tupplle* delations for LOGO primitives. Some of 
the declarations include LISP macros which replace calls to LOGO primitives with calk to 

fteir fdfitwr LISP i:Qun1rsrp»rts I Or efficiency, * n d :-Amrf OptimarafiOn is dOnc For Eafe1y + S 

sake, all variables are automatically declared SPECIAL However, the sophisticated user 
is free to include »n his proj/am OECLAPEs to VNSPEGJAL input Or Ideal variables 
which he knows will not be referenced globally,, or provide declarations which wilt matte 
use of |he I ast -arithmetic LISP compiler. 

A lew warnings about cOmpilina, LOGO procedures: First, remember that LOGO 
syntax requires that it be Known how many inputs a lunchon eipecti, before a decision, 
can be made as to how to parse a line o' LOGO code, H, whgn defmin^, a procedure, you 
include a call to a procedure which is rot yet defined, parsing is delayed until run time 
[see Section 6 and Serf ion 3.2 ol this memo far mo-re details J. The compiler, pi cOwse h 
cannol do anything reasonable with an unparsed fine Of LOGO cOd* d so atl parsing nyst 
be completed by the time the- de-flrMtion ol any procedure is compiled, the CQftPiLt 
function attempts to make sure this is (he t'tt- Therefore, II It an error to attempt to 
compile a procedure which contains a call to a procedure which is not a LOGO primitive 
and has not yet been defined. 

Also h i1 must be remembered that compilation of LOGO procedures, like these of 
USPj is not "foolproof*. It ■* no! always the case that a procedure which rum correctly 
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when ir»terprGtid, «rll he guaranteed tc run cOrractfy whan GO-mpil^d- SfiH -modifying 
procedure*, weird control Blrutlu ,r e-e 1 tf*i Ifl gen$fjl procedure* vrhich depend Heavily ° n 
maintBininii l^e eJ/ftemit environment of lb* inleTpralef m?y tall lo compile correctly 
without modilic atrOrk 
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Section 10. Using FiJwin LLQCO 



A file specification On ITS has 10ur cOmponenls. Each File is narred by Iwg words, 
of up to six characters each, a crevice [almost always OStfJ, *i*d i directory name [usually 
lhe- 5»mp as The user'? name^ You tan reFer to a Fi e n LOGO by using anywhere from 
lo 4 words. If you leave pyt (he n*ftie altogpthsr, it will be issumed that you are 
referring 10 the Fast file name menlinned. One word will be taken at the first file hiihb, 
and the second will default 10 > P which means lhe highest numbered second file name 
which currently exists it you are reading, Or One Prhjher iF you are wriling. Two words 
will be taken as the two file names, and! She- directory and davce will be delBulted. II 
three names are given, the third will be assumed as the directory dime, and the device 
will be DSK. If lour word* are given, |h* third Is devrca and fOurlh is lhe directory. Mere 
■re some examples: 



[Assume that the current user name It ESG* and FOO 3 is the highesl numbered file with 
FOG as lis lirst filename) 



LOGO 
iRtZADFIl,K foo 

rsAVE foo 

?READFILE FOO BAR 
iREADFILE FOO BAH HENRY 

*hh At}rtt.K rat) una dsk ft wry 



US I<fn]> <in2> <de*>^dir>;] 



FOO > DSK:ESGi fFOtt J/ 
¥00 > a&K:E5G- r IFOO 4 / 
FOO BAR DSJtrKSC; 
FOO BAR DSKzHE'fiRV- 

FOO BAR D$K:UKNRi\ 



See Section 12.? and Section 13 for Informal ion about File specif kalians cm the 
MULTIC& and TEP^O prnplementations. File specifications are accepted by LOGO in the 
sane format at Oft ITS, SO il may not be necessary to charje any code to run on other 
implementations. 



10.1 S aving a nd RfJldinf Filei 

Thert are t*0 ways Cl ^tyinE LOCK p'og r ans on the disk lor later use. To store 
lhe contents Ot 1he current workspace [all user Functions and variables currently defined] 
an the disk in th* Form of LOGO s&urce code,, use SAVE. It expects as mput a tile 
specification, as discussed above. The fife created will contain Ito contents oF lhe user's 
workspace, function dofmiljons and MAKHs tor variables,, exactly in (he lorm that he 
would see if he did * PRINTOUT ALL 

Workspaces can also be sav*d l« (JSP format, as Ihey are represented internally 
by LOGO- This is accomplished by lhe fund ion WRITE wh ch takes ils inpijls »s does 
SAVE, AHhyijgh (he iile crealed will not be so pretty to look ait if you print il, using 
WHITE produces fifes which we considerably fasler to reload,, since the program does 
nol have Id be repassed, For lor*g-1srm storage of programs, however, i| is recommended 
that you use SAVE father than WRITE. Charges in She implementalion pi LISP LOGO may 
fesult in changing the internal iormat ot LOGO programs, m which case, files created by 
WRITE would not remain tompatrble, but files created by SAVE would remain so. 
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To reload • file from th§ disK, Use the function BMDf/JX This, accepts > 
slandard file specification, anrt reads i» in, orinling the name af the,file. Rfi/lJ)f HE does 
not care whether the file is in 5dC£d or JFfifTten form li the J ile was r"7^lcd by Srtl\rY, 
lines of code will bo printtdl OUT *s they cOme in From the disk. Far written files, only the 
rUrKS el funcliOns, and values of variables will appear. If you git annoyed at all this 
output, you can shut it up with f-W. LOGO will return wilh a question mark when the 
loading is complete. 

It is often convenient ta [real i set at function* at a "package" Or "subsystem". 
For instance, you may have a *et of your favorite Iw^tions which you place in your 
i n=( i*h 2>i! i"n hl^, t:r a set C'F fu"-: ( ons des'3 r .fid 'er i tciiilit p „■■■ po. i it. Won thin is fir 
case, it is inconvenient fa nave all these function* wrilten out when yau sr e working on 
iddilional procedures, Or have to see their delinMions when you do a PRINTOUT ALL 
Thml is, om would like a mefhod of having ihe package Of Functions available, but nol 
considered at cart of the workspace by certa n i.a-nnands. Tqv can do Ihis by using ihe 
(unction RURY. it takes unevalualed procedure names as input, and wrll assure that Ihe 
function is ignored by Ihe Following commands: PRfNTOVT PRUCEVURES y PRt STOUT 
/ILL. PRt STOUT TITLES, ERASE PROCEDURES, ERASE /ILK SAVE, WRITE end 
COMPILE. Otherwise the I unction is una! Fee ted, and can be invoked, printed, edited, clc- 
A list of the r?me? of buried procedures is kepi as the value of the variable :HURI EO. 
fiURY ALL will BURY all currently defined procedures, and ERASE BURY will undo the 
el feci OF a BURY. 



LOZ Other File Command? 

PRISTOUT FILE [abbreviated POE] will prinl ou1 the contents ol a file. KRASR 
FILE will cause the specified hie (0 vanish [This has a safely check to make sure you 
don'1 do anything you'll be sorry about]. These like file names as above, o*cep1 that if 
only one inpul is given to ERASE >t daFaulls to '-, !** leasl numbered setoftd tile name, 
again for safely reasons. PRINTOUT 1NIJFX {POIf wil p'inl oul alt 1he file names in 
Ihe directory specified by one word. USE will change Ihe name of Ihe default directory. 
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Stcllon LL. DJffereicF3 belwrcn ULQCQ in J LLOCO 



LISP LOGO was cwiginally written lo be cOmpa1ib''& ^i|h CLOW, a vefsion nf LOGO 
written iin PfJPlO assembler language, Thpte now edits- ■ version of LLQGQ which w* 
belie va to be "semantical!/ cOmpahbte" with the PDF ll version. By this wc ^e?n that the 
vocabulary h the same — any primhive in HLOQO also emts in U.QG0 and will 
thopeiully) have Ihe same meaning, LLGGO in fact his many primitives wb*ch da nOl eiust 
in 11LOQO, a* well as ol'enng the user access 1o the lull capabilities «' USP- There are 
substantial differences belween LLOGO and HL090*itb regard to file systems and error 
handling, and soirewhal less substantial diFle^emes in t^e edilor t ^ ^r t ! e- and musit 
packages. These are described in detail in other sedions 01 Ires dOGUurtrtt. There are- also 
ire several less substantial dilFerenceSp not mentioned in the preceding discussions, and 
whait tallows is an attempl 1o provide a reasonably complete lisl ol the knowledge that an 
experienced 1 1LDGO user would Tietd to use LLQQ0. 

In 1 ILOGC h the double qU0l« charictar " is uied to specify thai t^e a'om 101 lowing 
it Is not to be evaltieted- 

■>PRrST TOO 
FDD 

II is like LISFs single quote, except thai it al=0 illetts Ihe LOGO reader's decision about 
when 10 stop including successive characters in rormifg the name or an atOn\ In 

?PRt NT .FOG+3 

the plus sign is a separator charttteii t\ signals the end dI the atom :F(iO just as if there 
was * Spate tallowing :FQO- However, Following ? doubk quote, lhp only separator 
characters, recognized are space, c«rr.i£* return, and square brackets. Thus t in I i LOGO, 

? PRINT "FO0*3 

FDG+3 

In I. LQRO, the user may use Ihe LISP single quale to speci'v Ihet an atom or 
parenthesized list loHOwinK the sing's quoit is no1 to be evaluated. The presence Of Ihe 
single, quol* does not change Ihe way LtOGO decides when en atom ends. In HOGO* 

?FHfi¥T >FOQ*3 

•,TMi: ItflMJT FOQ TO - ]5 OP THE WRONG 1 TYPE 

because the plus sign is still a sep-aralOr character, LLOGO uses the double, quotes as 
CLQQO does; (hey w always mslched. IF one s -expression (atom Or list) Occurs in 
be-twe-en double quotes, il is quoled. Ir more than One Occurs, the list c<?nta?ning them is 
quoled. The correspondence between L10G0 double quoted expressions and LISP s> 
expressions is as lol'Ows: 

"" «? ftft. 

■<tt> . . , StN>* — > (tyUQTE f<MJ» . , . , *ift>>) 
"(<>l> r . <iJV>r — > [QUOTE (<*l> , , . <jN>tf 



Thi fcrenee* be1 ween ] tUTOO and LLOQO Section 11 
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Square bracket? in It LOGO specify quoted hits, Parentheses art never uud 
around lists es in LIS-P,, but a-re only used In delimit farms, ULOGO recognizes square- 
brackets at well as LISP's parentheses in denoting lists. 71* difference belween brackets 
and parentheses in LLOUO is th^l the brackets always denote litt constants, and not 
forms, end that the outer level oF brackets is implicitly quoted^ 

ffFOO RARlf «> ftWOTE «FOO BAR))) 

There is e minor pitfall in the curranl implewenlalion: nole I hat lop level parentheses 
implicitly quote the list, interior Ones do- not. This does *ot »1ways wotK, for instance 
when using JTl/N-Dne may enpect inten'or lists a ; so to remain unevalualed-- 

rPHJATT f PRINT J FOG BAR}} --> <PRIM"(PRlPiT (fUO BAHM 
PRINT (KM BAR) 

muff/PKiptr fFoo bar}} —> (Run yp^/nt <foq barm 

prints the value of the- (unction f 00 applied to input BAR, 

Square brackets in L1LQQQ aiso share wilh double quotes the orOperty described 
above Of alfecling (he LOGO reader's decs'Qn or< ending the names ol atoms. Wilbin ■ 
square bracketed ist in ItLOGQ, an atom is terminated only by ■ space, carriage return 
Or bracket. This properly is not true of sqwe brackets m LLOGO. 1n LLQQQ, /F0O*3f is 
a list conlaining three elemen1s f bu1 in HLOQCv it contains Only One element. 

String quoting in 1LQQ0 is aKComnlished using (he dollar si|n character, J. LLGQO 
will fr«jit anything appearing bal*een dollar signs literally, wilh special characters devoid 
ol any special meaning. Within such a firing, two consecutive dollar signs will be 
interpreted at • single dollar sign. $o, t&$$ would be 1he word whose nane is a single 
dollar sign. W is the empty word. RubOut, edAma and interrupt characters cannot be 
quoted in this manner. Use the A$LTI i unci ion OF LISP if you really need them, 

The character sharp sign [V] in 1 1E.CO0 is used as a prefiK macro character 
which lakes one input which must be a word, and executes rt as a procedure. It is used 
where: One wants (0 use a weird name tor a procedure, or a name already used by the 
system. Sharp sign is used as an escape (0 call that procedure. Thus, a procedure 
deF red in 1 1 LOGO by TO 'PRINT . . . would be called by r'PRiNT* TO *J . . . would be 
(ailed by *"J, etc. In LIOQO, sharp sign is used as ■ macro character which causes the 
ne*| t -enpress ion to be interned as if t were read in USP i1 you are m LOGO, or an if it 
was read by LOGG if you are in USP. If you are in the LISP mode of LLQGO and wanl to 
access your LOGO JariableSj you can say r.¥ (Wv etc. The conflict may be ch-angeci in the 
near future by ollering LISP LOGO's macro character lo one thai does not condicl wilh 
1 1 LOGO Suggestions welcome. 

The Boolean [logical] constants in HLQQOara TRUE and FALSE, whrle m LLOQQ, 
ttwy arre T and rW„ as in USP. 

fhe ULOGO Function LEVEL, which returns the current procedure depth, is not 
implemented. 

ULOGO forms mt» divkled into two categories: those (hit output [return ■ value] 
and those which do not. In LLOGO, as in USP, every 10rm returns a value. To simulate 
1 1L0Q0 and CLOGO in Ihis 'esped, as a special heck, forms which return a question mark 
do not hive (he*r valyes printed by LLOGO's top level function. However, L LOGO cannot 
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catch I he error of *uth t form hiding inside parentheses h can ] I LOGO. Mosi of the 
primitives which do nol return ■ value ir, 11 LOGO relurn ? in LLOGQ. 

Tha character i in 11 LOGO is treated as i macro The vdy* of _". if A is bound to 
B and B is bound to C, then ;:A is C. In- U.OGO, variables set by MdAA' are iujt USP 
atoms, beginning with I he character :. so ::i1 will be the v^lye of the variable set by 
Ai/lKti "?/T ^wnaiewir*, etc We are seriously considering changing this, eliminating (he 
Incompatibility. The presenl setup requires MAKE to do art eipe-mive RXPlflflE On the 
variable narrw, in Order to crests the word *nichi begins with a colon. 

LLOGO e* peels to Hind only one form inside parenthesise constructs like 

■>(FH roo f D SfJ SVH 4 S) 

are prohibited, 1 LLOGO allows more than one (Oim inside parentheras unde' certain 
ra-striclions. 

The 11 LOGO 1 procedure- TEXT, which returns a list of lists which are the line? of 
a prtKfcChjre- whose name is given as input,, is not implemented in LLOGO. However, you 
can access Ihe delirntiOn of a Junction ifi it* parsed LISP form on the properly lis! [CDR] 
Of (h* atom. 

Comrnenls: LLOGO understands two comment conventions! USPs convention of 
Irealing as s comment anylhing bel^een a semicolon ?nd Ihp nail, carriage return, and 
LOGONS: ol heating *s » cammenl anything in between exci-arr align points, [The 
exclamation poinls must bo mitehecL and cotnmenls can be continued past the end Of the 
line]. Anything after end a real ion points On a line is ignored. 

The top level loop in LiSP LOGO hi a READ-EV/H-PRiftT krop mhereas PpPH 
LOGO is a RKAD-EVAL loop. This wins- that ] I LOGO prints out only when you ash it lo 
prkA (Jnlhto LLOGO which prints out values afler every evaluation Of a LOGO form. 

In tLLQGQ: 

?SlfM 4 8 

TQU DONT SAY. WHAT To DO WITH U 

In LLOGO: 



?i"c/JM 4 * 
12 



Line numbers can be any integer inside the INUM limit. Floating point, negative 
numbers and zero ire showed also. 

Percent sign {X) does not echo as a space. Carriage returns within square- 
bracheted lists prinl Out as such, not *s spaces, as In I1L0GO. 

-.EMPTY is the empty (1st, which Is U5r*s fill. lEMPTTfF is (he empty word, 
which is the LISP atom whose print name is (/15C(I OJ. 

The character control -T [^r] is converted 10 double quote ['J when il is reid in. 
This is for compatibility with CLOGC I haven*! the faintest idea of why CLQGQ does it. 

HSP L0O0 and 13LQQ0 differ on the syntax for arrays. LIEF LOGO uses the USP 
array facility! 10 define *n ?rr?y use: 
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LISP LOGO MEMO Fbge 37 June It, 1374 

1 ARRAY ^Hmi> T *iimm§iim 1 J , . . '-iimeiuUn Ft* 

Values can be slOred by 

fSTOHIS *erv*y nam** <«srJKript 1* . . <fu6*Mpi ft* *«ilue* 

Values ire accessed as if the array were « Function which eirpected Ihe same lumber of 
inp-uls- as the number of dimensions in the array, 

The tLOGO (unction R>WJJOM, ol no inputs, relurrts a random Float-rig paint 
number^ which is between rera and pr*. IF given two ('JunSpnFs, it returns 4 random 
number between its frrst and -second argument, inclusive, tf both its inputs are fitted 
point, il returns- a lived point number, otherwise If return* t Floating point humbeh 
{RANDOM fl> behaves as 1 11.000 RANDOM. 

■ 

LLOGO has Only one- global 1*s1 be*. When b sub procedure perlorms a TEST 1he 
result replaces Ihe result produced by any rEST"s prior lo the sub-procedure call in its- 
superprQcecture- JFTRUE's iftd ff FALSE?* titer the subproced-ire call in the 
superprotedure will be conditional On lhe lasl TEST wh ; ch wag perfor rred r regardless -of 
what procedure il w» In. 



ROUNDOfF In LLOGO takes either one or two inputs. If given dm input, the 
number is rounded lo an integer, otherwise il is rounded to as many places to the right 

of Ihft decimal poiht as specified by the second Input. 

IjQCAf. variables are handled d<F1erently in LLOGO thin In 1 1 LOGO. Regardless of 
where a HUCflL statement is placed in a procedure, the variables declared svi'l be f ncal lo 
lhe entire procedure. This corresponds to ■ P KfJG variable in LISP. UfCAL accepts any 
number of variable name* a* input- 
Inserting, lines' inlo procedures under program control should be done using the 
funelion INSKRrfJNR. In I1L0D0, the following will inserl a line into flJ.FvTTCIf when 
MUffC is executed: 

1T0 MUNG 

>J0 EDIT RLETCtf 

>29 10 PRtNT fNBW LINE ADDED TO BLETCH f 

>RND 

Thlt wilt not work in LLOGO, Instead replace line 20 with: 

>SC INSERTLINE 10 Pfif\T {NEW LINE ADDED W BLhTTCHf 



There it a memo by Wade Williams which explains seme o1 tne liner points of 
LI LOCO syntas h and should be consulted lor Further inlOrmalion. the 11 LOGO User's 
Manual should ateo be ot assistance. 
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Seel ton I3> U eI rag LLOGQ an MULTTCS 



LISP LOGO has now been implemented on MLTLTICS, and this is. the only version Df 
LOGO available for 1hat system. Below are instrucliOns for using it, and i list of 
differences between (he FdULTICS and ITS versions. E*cept for the deferences in (ile 
naming conventions, and limitations imposed by (he operating syslem., source language 
programs should be enlirijly compatible. For more information on MULTIC5 LISP, see the 
MACLISP Relerence Manual by Cave Moon 

The LISP LOGO muiit package is avail abe fDr tse on MLtTCS. See Section IS For 
More details.. The display turtle and GEPWLANO packages are nOl available in the MULTCS 
implemenlatioriL. MULTtCS does nOl have adeauale facilities J or utinsi dispF*ys such ft |h# 
340 a-nd the GT40. tt prpbabiy would be passible to impFement a rudimentary turtle 
package for the storage lyP& displays On MULfrCS such as the AflfJS *nd TtlCTROfiX 
1i;rrmn»l=, but we have no plans Id do so a1 present We do hope to have available soon, 
however, facilities for using the norh^itjl fk»r turtle* [controlled by the Thornlon Ban] 
on both US and MULTJCS. 



iti Where To Find U 

To obtain LISP LQGO h you must Urst create i link 10 Ihi necessary l<l«s. Alter 
you log in h type 

This needs to be done Only one* Per each met- Subsequently, you can get LIOQQ simply 
by typing 

Ivgv 

You should then get a iressage Indicating the vers.ion rubers of U5P and LOGO, « on 
ITS, and I he- allocator will ask you iF you want to use the music bow. Ft you have ■ FHe in 
your directory nam^d nam u.p.Iaga it wilt be read in as an initialization File. 



12,2 File Naming Con ven Horn 

An ITS File spec ilical ion consists o' two tile names oF up lo si* ctwaclers each,, o 
device and directory name. A File specification on UULTrCS is &*-fcd a "pathname", »nd 
consists df arbitrarily many componenls each naming a node in a Iree structure of 
directories and segmenls [lile-s] The components of a UULTCS pathname are separated 
by ">" characters. Any pathname beg.innii\g with ">" is considered to be a Tull pathname, 
i.e. slarl at the root of Ihe tree, clherwise, it is considered to ba relative 10 the directory 
wrnch la currently the default This will usually be something like "^udd>y our -project - 
name>yOur-u5er-nsme-'" r Fil# nam^s in assumed also to have two component ; ^ on ITS 
and you type (hem inlo lo LOGO the same way, as two wOrds h excepl thai each word is 
not limited to six characters. The default seed m fiFe name is. "ioga",, not ~>^ to be 
consistent with MULTfCE conventions, Irt your d>redOry f the t*0 iile na»nes wj|I appear 
separated by a "-"- Fires whose second narres are "fasl" are assumed lo contain object 
code produced by the LISP compiler. This will correspond to the fiFe with only the First 
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name [no second cnrmppnent'] in your directory. He re are torn* •Kimpin?: [assume, your 
name it "person" and ycHjr project is "project"] 



LOGO Pile nam* 

?i*Mdfife /pd bar 

^rwadfiln fat} fatt 
VrtHf/litf fw bar ihnmhld 

-'rrad'itr fa* far ■vj.rf.f :■ Ji",.^ 



MULTICS file n*me 

>wiit>tifaji>fi:- pttt fl-rP/rM-Jej* 
^ttitl* project s pnr j an^faaJinr 
'*udd*pm }f.r I? fiffwn* f&& 
^ui&prlfttcl* ptrtan' mu mbIt>>fanJwr 
>add>UogB>f9v4>9r 



]?3 term inulpgy 

On MULTICS, tonUel characters are entered lo U$P by (int hitting (he break Or 
etln hey {iF you have one] end U5P shoyld type CTRL/, lh#n typing |he ordinery non- 
control character, then a carriage Tffturn, NULTCE has no other way of a<.knci*-lpdE ng 
•your existence before you hit a return, which i>s Ihe reason for this kludge Because of 
this Ihe contrail character line oriented editor which exists in the ITS implement atrar\ 
does nol emst in Ih* HJLTC5 irnplernenTatiOri. MULTIC5 uses t to rub out the previous 
character, and B lo rub out the entire line. To e^ter these characters to ULGQQ, precede 
them with \ r 

It you should have to use an IBM 274 L terminal, r rjrrernber thai certain characters 
must be escaped, The- werst eiFendeis vn f and / [type <ectit*iign> 'Irnx-than? for f 
arid c e*Jll-|l.gJi* "Cjrrtler-lrrnH? far /), type <nrtr-jujn> for A, <cen[-|Pfl-rj> ■CffW-lff Jl* fOr 

V and type a <r.Knt-i£jin> before * and 9, Upper and lower cases are distinguished on 
rWU-TlCS, and all 0« the syslem functions, halh MULTICS's and LLQGO's, ^•-•r. lower taw 
names. 

To use LISP LOGO en MULTrCS over the ARPAtttT Iron ITS, rt is recommenced that 
Dave ktoorVa program TNfi be wed ralhet Ihm TELNET. See DSK:.lNFa.iTN6 INFO 1or more 
details. 
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The version ol LLOGO tor TEN50 rvns in a version or MACU5P (hut is n**rly 
compalible with thai used at MIT-AI. The TEN50 version can also be used an TENEX 
systems. Most o( the- incompatibiliSies ir* lh«fl necessitated by (be diFterer»cc in 
cperflt rg, systems. Specifically, lb* 'Slewing commands are nol implemented: 

PRLYTOLT IIVOEX (atiet POt> LtST FILES) 
IjOGOUT fflVW 
CO JH PI Lt 
fJWEPRMT 

sm 

Alio, Hie special packages for LLOGO {the little primitivea, lbs music primitives, and 
GERMLAFvD) a*e unavailable. 

Another diflerenco between TEFJ50 LLOGO end LLODTQ on CTS is in the lyping ct 
control cttwactefs- (such as .nG,. A-ii, and all the edging, characters - r\R r\K etc.). on ITS 
these characters may be- typed J*t any lime. Those specifying an interrupt aclio^ (■*£, ftJIJ 
Will always take eFtect immediately. UnFQrIunately, this is not Uue in Ibe TEnEO 
implementation, because TEN50 allows a rw*ning program to be interrupted only by the 
character aC As a resull of 1his, \i the user wanls to interrupt the LLOGQ system while 
it is running (e. &. execulinl a- user delintd (unctionl, he must lir'st type *C This will 
interrupt the p'ORr?iir-, and csjse t 1d print *\ indie aling lhat it is wailing to read a 
conlrolKlwactEr. The user may 1h&n lyp«j thr desired control-character, and it will be 
acted upon- Note that typing r.t is nat necessary if the LLOGO system It nol runrmg., but 
rather waiting for input. TherelOre the Coatirtg, characters may be used wilhout diflic-ulty, 
tve;n on tbr TEnSO sy stem. 

ArtOther minor diflerenee between- the two operahng syslefn* i? in the nol-ation 
for lile names. TMb, diF"erenc* is minimized by Ihe syntait used by Ihe LLOGO file 
cowhands. For instance, the command 

HtEADFILE PROGRM USO D5K USER 

will read the lik DSKMSF.R; PROGRM IjQQ on ITS, while on Jtititi the hie read will be 
DSK-.PROGRM.LGGflj'SERf. Thy^ most user programs will be able to run whh Utile or 
no modification to Iheir input/oulpul opefalions <T*1e Ihat the delist second Me name 
is > On IT'S, while On TEN5Q it is LCQ) If ygy want 1o use a LLOGO inilialirslion <ile wj|h 
the TEhBQ rmple mentation, the name ot the File should be JrVITVtCO on your user 
directory. 

A version of TEN50 ULOGOis currently available at Garmjgie-ldellpn (CkAMQFJ). * 
may be loaded there by mean; at the following command: 



Uitnf LUM» mi TENSfl mi TSHEK ntUm* Sr.hu-., ]? 
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Th* GERWLAND pic-ka^e is designed to provide the user wilh i display 
environment in which interesting, nontriyial quesliQns c?n easily fee inve*hgated p without 
[tie need For sophisticated display Sq)wprti*ri1. The turret implewentai: on ru-is en ar-v cF 
the character display console? in ww at (he A.I. laboratory. 

Conceptually. GE.RrA.ANO Consist* of * S^uue grid, on whkh may live" as many 
*S 10 "germs". Each germ may have an arbitrary LOGO prOgi-jm pssO^ialrd with itt this 
prpgrarn determines the jfcrm'ii movements, -as *ell as whether it eats any *1 (he "loed" 
present at its position 0< the £rid, For a drscwssiQn of some rjt th* problems, that can be 
investigated in lh|$ environment, see LOGO working paper 7. 



] 4, t Starting Up 

The GEPMANO package may be loaded adonalicaMy a1 the -si art OF ail L.LOGO 
run. When started, LLOGO will as*, which of the Epeiial package* y ^ W4flt - Simply type 
YES, followed by * c*iri*t* return, when it bsKs whelher you want GEF?ULA*C Th* 
GFRMLAND package will than be loaded, and give yOu instruction* lor lurlher help. Note 
thai it the grid twcOmes gabled, because oF a transmission error for insUnrr-, you t*n at 
any lime cause it to be redisplayed by typing th* character a\ [eofltro*-bac*slashl 



14.3Taple«tl FrtmHivf* 
itUNGFRM 

Invokes prompter. Asks quesdens necessary to get started and otters help. 
CERNDEHOS 

Runt a series of demos, leaving the demo prOg-rams available- lor the user lo play 
With, 

TOPGEMt 

SUtts tip a GERrAAND REAlhEVAL-PRfffT k»p P ming the grid set up by th* 
most recent call to RUNCERM- 

UNCKiD 

Exits from TQPGERM. bick to LLOGO. 

REPEAT <profratn!> CptagMtmZ* _ 

Each program defines one creature. A round consists ol *n*tvti^f, each program 
In Hum, After each round, I he program wait* for inpu!. 11 Ihe user types a space, One 
round i£ pcrFormr-o";; il Ihe user lypes a mrnibef, that mpny rounds are done. This is 
repeated indef nile'y uHi' an cror occurs. REPEAT is not subtle- with respect to 
parallel proteasing. I*- effort is made to try e«h program and see whelhec any rtnUfcts 

GERMLhND S«'l" "^ 
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Occur, Howover, eventually n ndru elaborate version could be designed that was 
serKilive to synchronising the lives Of the germs. II no programs are passes '° REPEAT, 
it attempts to use the programs associated with each germ by flf/JVCfhVH . 



14,1 Grid PrtmiUvfl 

CfiTD «nupiO«r> 

Initial ires GERMANS. A square grid is Ereited with <number^ squares in a side. 

Clear screen and redisplay GERMLAND grid. Typing, a.\ also causes 1 hi-s Ic 
happen. If there is a germ on the squire, the character which represents that ja^m is 
printed in I he square's position. Ft the square is an Obstacle, m "X" n printed. 11 [her* fa 
food On the square, the numoer ol parities is printed. II the square -s erapty h ■ V rs 
printed. 

CR1DP -[jwiifpQR> 

A predicate which Outputs T Hf the position** a legitimate grid square. 

wrap 

Bo into "wraparound" node, in which germ are allowed to go across the 
boundaries of the grid. 

mWRAP 

Leave "wraparcgnd'mode. 

NMa ttWt WRAP and NOWRAP *lf*ct Ihe variable :!FffaPdrWJVD See Page OS. 

Jtf 0t'£ Cfrciifian* 

The germ is moved tn the specilied g/id square, ^position* is a sentence Ol the x 
and y coordinates OF I he square. Typical use 15: MOVE rVOflTfrV II th* sjl-rrni move* to a 
square which it already inhabited, 1he few wer inhabilanl is hilled. MfJt'F p'inls an error 
message il an attempt is made 10 HtJYE 10 a square with an obstacle Orv it, Or a square 
Outside I he grid. Ths ^positron:* doe* not have to be adjacent So the current location ol 
the germ. Hence, MOVE a lows non-local movement 10 any grid square. 

STEP ^d^Miton* 

<direclion* is interpreted as a heading. It must be erther 0, 90, ISO Or 270 (mod 
36Q>. STEP allows more elegance in (he description ol a term program. If ihe same 
structure is used for all directions, then the program can call t subprccedu r e whose input 
i5 cycled Ihreugh Ihr four direct-Onj. 
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14.4 Property PrimttlTies 

PtJTSQiJAFR <;wiil£oh> <infr?rttialUni> <mpnrty> 

For th* specified grid t*J*f», th» data stored under th* Jrv*n propi-rly >j set to 
information^. 

CETSQU/ifM -piuHiw *ptttptrty* 

The inlOrmaliOn stored under (he ^properly* is tb turned. Typical trees ar*t 

(CKTSQUARF *p<ttiiUtt* 'FOOD} returns food at <positiurt>. 

•'CETKQl i /iRR <poiitian> 'IMIABITANT) r«|ur« the number of the germ 
currently living. Itier*, fYJL it unoccupied. 

(GETSQVARE <j»i piumd QBSTiKLE} return* r ilf th* tquvt Is *n obstacle. 

Removes information s1ored unda r i "Drope r ly>. 
WHAT "poiuitW> 

Outputs all Of The inro*Tna1i<5n stored for 1he given position. 

FOQ& ■ fo.niio.T- 

Outputs the number af rood pirlcles at the given position. FOOD return* 0, not 
ML, when there is no lood 

FDODF *patiium> 

Predicate which returns, number ot food particles il any at the g^verr position; ML 
if now. 

FIUFOQD <n* 

Puts <n> morsels oF Food On each square OF GUHMLAMX 

FAT *mmmbir> 

Subtracts ^number* Ol food parlicles From the current square Generates »n 
error if ^number 5 is larger than the total Food Available. There are two types of germs 
— those that are hungry and those that are no1. Each, hungry germ has a Food supply 
associated with It. The <OOd supply it increased every time he eats by that number ol 
particles, and decreased by one for each genera I ion. 11 it ever reaches zero, the germ 
dies. So,, if he eits Only Or* pfrrtld* ot food on a turn, ho must eat again cm th* neift 
turn; if he eats 2, ha can skip a turn without eating, etc. 
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14.5 Multiple CfTm PrimltJrea 

WHERE <;e*rm> 

Rsturni the coordinates of the square that iferjn It ?uirefltly kfihibtdng, 

WRTUP <gir^> 

fie turn* Uue 0"% «' tne * coordinate of rgarm i^ greater (hart the X cwdlPUtt of 
I tie ggrm whose program is curranlly hamg axacded by REPEAT. 

SOUTH P t WESTP,EASTP 

Analogous to- NQftTHP. 
KILL <igtrm* 

Assassinates ^:germ> and prinls eulogy. 

GERH <:£nrm> '■foam* 

Initializes :g.errn to tli'l out located i1 ^square?, jgerm Is an Integer between 1 
and JO. 

FQQD&JPPM *tg*rm* 

fie turns the amount o' food 1 hat 1hs garm bas, 
/tCCESSIULE ^iquartf> <t|*rm> 

TV ut if and &n|y if <;garm> can gat to Square" on hre rwitt rnova. 

H.6 Turtle FhmltlTw 

HMD! JVC -:?tf«™> 

Returns this tumont raiding of tht gerrn, 

FOffUMITI) tneimfjrr? 

Move <numfaet> spaces in the direction of 1he current heidartg, Abbreviate:* to 
FD ^number?, ^number* may be nsgaliva. 

BACK <numbtfi j > 

Move ^numthtr^ spates oppcmle to the c^rpnt having. AbbraYiales tr> Bit 
^number*. 

Relurns lha coordinates Of 1ha rtexl square in Ihe current direction. 
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RIGHT tnumbef* 

Tutni rljhl ^umtwr* d§tr#«— <wtihet ► thould bt i multiptt cl 9C. Thit w? be 
abbreviated a* RT <rvumber> . 

LEFT <niFH0*r> 

Eflulvtltnt to ffjT£fJT -<nurnb#r> P Abbreviate* it £X<numb*h>. 

Rtlurns -cwrdiiutet Of the squirt in frqnl of the lurtl*. 
JUG/miDr?. RlMR r LEFTSIDE 

Analogous 1o rflOiVT. 
FSfDE, R$IDE> BSfBE, tSf OB 

ADbr'tvitiiDftt few rmm ele 

14-T Touch FH mH Ives 

Gulpuls JWL If ^position* -does not contain saroeltiing thai can be fcutted. 
Otherwise it outputs an atom describing Ito tQuchible Object, e.g. BORDER or 
OBSTACLE, Typical u=e it: TOUCH JWJYT. 

OBSTRUCT <j?uiLfw> 

Puis an Obs-Uels aj <%quwQ>. Qe-rnq etwvot move onto square s wilh obslscles-. 

nF,STtajcr <jqnArv> 

RemQ^t-s obstacle at <square>. 
HI Global VifliblM 

Ttie number cl lb* jerro *hose proflrirfn is beirg executed by HEPE/IT 
£M05/£E 

Size St Ihe G£RMLAN0 jrid »( by the CRIB function. 
^HUNGRY 

T ■* Gerrns **« fcilkd il their foadsupply joes 1o 0. 

ML -> A (•i-m's foodjuppty ia i|nared by REPEAT. 

(IFRHLAIID SfftSmi 14.1 
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WtUtPMIUXfMB 

T -> Motion «ro« borders I* permHted, 

NIL ■> Motion Across borders is m error. 

The user should never change iWRAPflRQUND directly. Use WRAP and 
WJTfldP ta change modes. 



n.9 impiementniwi 

GERMLANO uses *ti Stray to represent lhe grid, and additional arrays for easy 
access 1a information about a particular £*rnn. The- individual primitives, fire, for the mOsI 
part h straightforwardly implementable, given Ihts data representation. Sow* $*r& is tah^n 
In IntorMdng with (ho standard LlOGO enviriOnmenl, so Ihs1 all Ihe usual debugging 
features oF LLOQQ may be used In the develophr*nt of germ prog'arrs t without 
Infer Mre-rKi wilh the display of (tie grid. 
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Section 15. Display Turlte Primitives 



The display lurt'e package for 1he 3*D and GTflO is also usab'e From an ordinary 
LISP as well as from LLQ&O. Do ffASiDAti TVRTLK fASL DSK LLQGQ) Id get tbe 
simple display commands 1ik* FORWARD, RIGHT, etc. and tJASLOAD DtSPLAY FML 
BSK (JJJGQ) for the fancier snap-manipulating, commands. 

Abbreviations for the Following primitive* in noted in square brackets. 

15.1 SUrting Trtf Diipllf 

STAflTmsPMr fSBj 

Initializes 1he screen. The turlle is displayed at its home, Ihe cenler ol the 
screen. This command is also use'ul Fo r r ss1ar1ing everything when things get fouled up, 
Ihfl POP6 loses, etc. STfiRTOISPLAY Cr« uses 1h» GTHO display rath** (nan the 300 
display. If you are using the GTW as a display Icl^e LOGO lurVe, f must not be logged 
irt TO ITS as a cOrsor*. 

WDisP^jir /jvji; 

Says, you wan) lo stop usim the fepley. Flushes the display slave. 

H Ihe display slave for the- PDP-6 dies, ch*ct IhiT 1h* run light It on. 11 -tot, stop, id 
reset, deposit in 4Q and 41 ind I hen start. 

LISP has three tonlrol characters for the display: 

A/V 

Turns olf display. 

ait 

Display prints like tly. 

turn* On display for lurtl*, assuming, a prior call lo ST ARTDt SPLAY '. 

15.2 The TMfllP 
HiDKTUfiTL£ ftiTf 

Makes the lurtle disappear. 
SHOfPTURTLt: fSTJ 

Bring.! the turtle back to life. 
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TVRTLRSTATE 

Returns if 1he lurlle. is not displayed, else returns the value af -.TUftTLK. 
iTURTLE is the number ol tN* display iltin which is the curre*v| lurtfce. 

HAKTURTLE <w«V 

The Current turtle It replaced t>¥ the picture drawn by ^code^ ftewides 
capability to rotate pictures. Subsequent turtle commands, fiK# FORWARD, HfGHT t etc, 
will make I he picture drawn by ^cflde 5, move « if it Wtre the original turtle [triangle]. 

QLDTVftTLE 

Restores the original LLtKJd turtle, 



IJt.i Moving tht Turtle 

Moves the turtle isteps in the direction it It CUtrenlfy pointed. 

hack :u«pi /ant 

Moves 1he turtle :steps opposite to the direction in which II js pointed. 
SETJl it 

Moves the turtle to fr.YtBH). 

strrr v 

Moves the turtle 3d (XGOrT, :y) 
StTJSJf :r:r 

Moves the turtle to <:*, ^¥>- 

Move? tut (I* to iXCQR+dt, YCWX 
JJfr > s*j 

Mo™ turtle to (XCOR, FCON*:dy)L 

DKLXY :*t Ay 

Moves turtle, tn {XUPR***. KJlfi+rfy), 
HOME f ff/ 

Mo^es turtle home to i1s starting si ale, 

n t =pla r Turlfe Primitive Sfectlan 15,3 
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1H4 Erasing thj Scfttn 
IFIPK 

Erases, the picture on the screen, due* ncl (fleet the tUrtHi, Or *ny sn*p>s. 
WIPEtLEAS fWCj 

LtKe (F/Pfi, eicept hides snips. elsO. 
CLE/JRSCKEEN fCSf 

Eouivilent to BPIPE HUH fc 

15.5 Turning the Turtle 
fllCffr nrtffe fRTf 

Turns the turtle tbocfcwise fanjla degrees. 
£ EFT «jn*Je /XT 1 / 

Turn* (h* turtle counter -tlotftwis* Lanule degrees. 
$STHE/lD;tt* t lw 

~ftm turtle is turned to 4 heeding o< :angle. 

15.6 Ea a mining the Turtle t State 

Nolo; The turtle"? hOma is <Q f 03 and 4 heading nl cOf responds to pQin1i"g straight up. 
The variables -.XGQR, rVCflJt end :!fE/iD!NC describe the state af the turtle in I lusting 
pdrtt. These variables should not be Changed explicitly by The user, The tol lowing 
(unctions relurn ca^panenls of the turtle's state rounded tD 'he r-es-'esl integer. 

X&iR 

Outputs the X coordinate ol the turtle, 
YCOR 

Outputs the V twrdinjte of the lurtle. 

HxamNG 

Outputs I hi heading of 1h( turile. 

XHQJHE 

Outputs tha X enafdlnitB OF the lurtle's home in absolute scope coordinates u.t. 
rallliv* to lower lelf-tiend corner of the %t**- ■ - .■ 
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Y/fflME 

Outputs 1he ¥ coordinate ol (he lurtle's home in absolute scope coordinate*. 

15.7 The Pm 
PtfrVMIFJV fPDj 

Prn lowered to paper. Turllo icavas ■ tracK when moved. 
PENUP fPVJ 

Pen raided from piper. TurlFe does not leave a track when moved. 

PEHsran 

Returns +1 - per*up qr -I - pendown 

PENSTATE <t or-t> 

Sels- I he perflate. A. cOfinnon use for 1his primitive is to make a i.ub-prooodurt 
transparent to pen sl+te. 

PBNP 

T H p*n n down, u\vs NIL 

HERE 

Outpuls {SENTENCE XCOK YCOR HEADING). Useful Tor remembering location 
via JU^Kfe'V HERE. 

5ETTURTLE rttttw fSETTf 

Sels I he stale of the lufHe- lo slil*. state re a sentence it X coordinate., V 
coordinate, aid treacfrng* The heading iray be oimtlsd, in which case it is not a1 reeled 

RANGE ifi 

Distance IfOm the I ur tie's- current location to :p. :p ia b poinl sped Med by a 
sentence of X and Y coordinale-j, 

BEARING rp 

Outputs absolute direction of :p from turtle, 
TOWARDS :p 

Outputs rtlall'.'t direction ol :p iron* turtle. 
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15 fl Global Mavigilion 

Note: Thete primitives return Floating poinl il either nt thair inpuls ire ftasling point. 

RASCE n r r 

Outputs drstance ef turtle rrOfn th* point (m, \y\ 

BEARISC si :y 

Output* fltreolul* diredion el <a K ?J from turtle-. (SETHEAD (BEtWWG ;* iff) 
potol* Ihe ti>tto in Ih* ■dkwtlenfli (*,#}, 

Outputs, relative direction cf (a, y) lrtrn turtle. (RIGHT (TOWARDS :r iff) 
points 1 he turl le- in the d»r*ttlofl of (m, tyj, 

1M TrlEQnwnetrr 
COSINE n*gl* 

Cosin* of tfngb di|r'*»t. 

Sine ot wangle degrees. 
flTAPfSENt js ;y 

Angle whose tangent ia :i(/iy. 
[SIN, COS, end AT AN *re the corresponding Function* which input w oulp-jt in radiins] 

1SJ0 Text 

SHilWTEXT 

Subsequent printing is moved on the screen. Initially, printing begin* in the upper 
left earner. 

HMRTEXT 

Subsequent printing is- nO longer displayed. Text currently on (he screen remim*. 
RKMTKXT 

Any Tm1 on the screen is *r*i«J eno" subsequent printing is nal displayed. 

:$fJ0IF 
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A verbis which is r if printing. is being displayed, NIL i< not. Est by 
SfJQWTEiT. HIDETEXT^ and fiEJMmr. Don't set it yourseH. 

iTEXT 

Variable enntainifj the number of the display item which is tha lest display ad by 
SltOWTEX T. etc 

JH/ItfK :r 

flTPE j!> is placed at IT* turlU's current location. S/W "ifcia" JMJTK "l«l" 

creates a map of the word le^t". This allows Ihe word to be manipulated, Le. Moved to 
any part ol Ihe screen, ate. 

iTEXTXHOME. iTBXTYHOME 

Variables conlaining coordinates Of 1sx1 to be displayed on the screen. 
Ch^nKpabli, h ¥ user. Initi.ily :TEXTXHOUE- 0„ VBXTVUGHE- 1000. Thwi art in 
absolute scope coordinates. 



15.11 Manipulating Scenes 

Note: iPICTURE is the name of tha turlle's tnct Does not irrtlod* any snap* displayed 
via SHOW. SHOfFRNAP, ale. :TIJRTUI is the naire n1 Ihe turtle. ^£^7" is the name of 
any lent displayed vie StitiWTEXT. 

SHOW :»t«w 

iscene is moved lo 1he current position Dl Ihe turtle and displayed It is not 
copied, 

flfDE r«en* 

{Scene r* hidden bul" not destroyed 

PHOTO "jmm* /SWjTP/ 

The current picture if copied and named :tcane. Any old snap nl this nama is 
destroyed. 

The picture drawn by <line* is named scene. 

KNTKRSNAP "uW 

.'P/Cn/ftE is rebound to a Fresh display item, the initial state at this item hide* 
the Itirt&e. -Subsequent commands, refer lo this new Item, 

KlVDSmP 

The original -.PICTURE is restored. 
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RESNAP "ictnc" 

Stftrt* is mad* lhe current picture. The onty difference between thr* and 
EiVTERSNMP "irtfte" is that a new display item it no| ci-g?b4, md the lurNe is nOl 
hidden. KNOSNAP *ht> r^lores the Origin pi jFfCTL'fit'. 

The picture drawn by tiire* <s added Id rscere. The <l ne> is e*eeul*d, r»f*»rinj 
to the turtle residing in iseene. Suhsequenf commands -*hII re'er t* f* pld 1ur1le. 

P/CTC/rtfi '-dir^aj- e*Fitmandi> 

rf'ICTtj'RE is bound 10 a new display item while the commands, are executed. The 

Qri&inal ^PICTURE Is restored fol>0*i^g, execution of the commands. Similar to SWAP 
'mrwinf" <c.Qinmcvdt> except (hat no name is gi^en lo Ihe new item, Instead, 1he number 
Of the item is. relurned. Thus-j Ihe same elfect is «hl*ved byt 

S?iAP 'ipnttT <cvtitniQitdt> or 
M/lKft h «*n** PICTURE *tontmnn<ii> 

Except thai rscena is. rot added to Ihe list at snap*, 

SHtHPSN/lP :ihm 

A copy ul scene is displayed! at 1he turtle's current position. 

HWtSSffAF ,«rm 

All eopias of sun* an* hidden. 

All copies ol scene are destroyed. 
;SNAPS 

A list cantBining all current snaps. 

IBM Plotter 

PWTTRR 

The display is plotted on a new plotter page. PlffTTKP Mill kK if arrays from 
previous pto-t should be erased. Tht user should type FES if his preceding plot is 
complete. 

PWTTKR I 

Display plaited on current plotter page. 
NOPLOT 
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The plotter It rttafetd. 
DISP/tCB 

Outline or 7*1 1 page displayed is iFJIGE. 

I5.1> Fou 

Oulpuls Ihe value of pnt s « i dat-i^ll frwdOn between and I. Careful: |hfl 
numbers On the p01e are marked in octal,, bul LiQGO normally a*petU ctoci'mal numbers h 
inpul. 

15 H Point* 

[Ppinti *t* displayed whelher fir not Ihe cen = & dc*"J 

fr^plays ■ poinl il (he lurlle'i current localton. 
POINT :p 

Display* * pom! it :p. 
POINT jjrwp :» 

Displays a poinl in snip at :p. 
POINT una? ;* iv 

Displays p poinl in snip at (:*, vf) 

1S-JS Global State of the Turtle's World 

For all of th#se 'unctions, the lint input "scene" \% optional. II left out, the command 
refers \u :PTCTVRE by default 

SETHGHK mmm 

Gesels turtle's name to current paiihDn, 

SETfiOMK item* i* z r 

Resell Ihe lurUe's home la |he absolute scope coordinates of (:*, ry}. Takes 
effect immediately by rnOwng the current rPfCTt/RE [a the new hOtre. iSETUOMR :k<iii*i 
512. $12.} restores, the home to the canler ql the screen. 

MOTION ittent 

Diifilajr Turtle rYiimlivn Seetwnt 15.15 
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Moves iscene under I he control at *p«e war console I. Bui ton terminates 
rnOveme-nt, The new home 15 re1urned f expressed im sfscilytr scope coordinates. (F th^ 
current home it returned immediately and the spite wm console is ignored, ehfcck tM pH 
switches on [he color scope date switch extension are in the middle position. 

BLINK ucen« 

Blinks :scene. 
VNBUNK utent 

Terminates, blinking. 
BRIGHT :ir*m 

Returns, currcnl brightness of :scene as 1 number fro*!* 1 (dimmest} to B 
(brightest J. OrdmaMy, :7T/flTX*; end 1FICWRE are at masrimum briahtne*:;. 

HR/CJfr r»WM :fmf 

Sets brightness nf 4Ctn« to :I*ybI, where i 1 evel is an integer from 1 to SV 
SCALE, jJcrho 

■ 

Returns current scefe ol scene. Scale is in integer from \ |s-U*dard seat*! to 4 
(1$ times standard scale}. 

SCALE :tt*nt \axt 

Sets scile o» ace"* to rsiie, where *iz# is a*% integer from 1 to 4. :iize is a 
Wulti^icative scale teeter. Hence h SCALE 2 double* the size of an Ordinary picture, 
SCALE J Quadruples ■( and SCALE t multiplies the size by 8. SCALE I restores picture 
to sta.nds.rd size. This is a harCwere Mating and fllfects the current display as well a» 
future displeyege, 

DSCALK zmr.aU 

The length Of 4 turtle stag is resel 1o :scale. :scflle may be any f O*l number, 
Reselling the scale with PSCflLE rather than SCdt£ has (ha advanlage that the scale 
lector rv^y bo jmy real number. However., BSCALE applies Ofllf to future display and not 
Ihe current picture. 
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Sect ton IS. The Musk fio* 



The music box is t tone generate for From ana to four sinullanecus voices, 
having a range Of five oclaves. Secnrse ol tNj timesharing environment, musk Is 
compiled into a huffer, and theft shipped to the muse box all el once, for smooth timing. 
HVhrrever possible, lhrmr: primitives havn been made compatible wHh bolh those of 
POP 11 LOGO and PDP1Q CLQrjQ. They made be used with Ihe "did- (MinskyF music box. 
Or the "new" (Thornton box compatible) musk box. 



16.1 Plugging In 

To plug in the old music box, Find an DiECtlPQflT terminal. Piug it into a 300 baud 
ITS Hi"*, using. I he phono type plug on the lop righl at the EXECUPCP' back, Or I he 
acoustic coupler. Make -sure the terminal is turned OfF b and plug the music bos into I ha 
leFt back ol the EXECUPQRT. {Of I ind tl>s all sat up in the musk room an the third door.) 
Turn off Ihe music box and attached percussion bo*, and pul Ihe EXE&FDPT switches 
into the "line " and "uppercase" positions. Turn on the terminal, lype r-7. and log into IT5- 
The panic procedure tor the old music bo* {symptom: keyboard dead but ITS no! down) is. 
to switch to local lowercase mode, turn oFf the music box, and type h,. Then type tP- 

Whpn vi fig 1 rin mi/sk. t>0* from KJIJLTICS. '« rr-n mfce r V":i1 Z-ii*- cgm^ rr'urn and 
line feed musl be typed tc end a line, when usirvg an HXECUPOPT. The terminal should be 
in Ti-aM duplex - and "lower -case" modes. The panic procedure described above is not 
rrcorrimendcd, since pulting the terminal mlo local mode will have Ihe eFtod ol logging 
you Out or MULTICS. 

Plugging in Ihe rew music box is a oil mora of a problem due to limitations at 
present hardware. The critical item is a small piece of electronics known ai the Terminal 
controller card", to be had IrOm General Turlla hi the basement Of 5fl5 Tech Square. This 
card is to be insetted in the correct orientation in port lot a Thornton bo*. (If you have 
never done 1his., ashf Puding i1 in backwards wi ; l ourn out Ihe card.} ~ n * ikjlIc box 
should be plugged into port I, 2, w 3, depending '..pan wh-ch has t*e mkpic bo* card {It 
should be labelled.? Then, plug the interlace connector oF IF* Thorton box into a 300 
baud ITS line, a terminal into port 4, and log Into ITS. The panic procedure (or 1he new 
music box is 10 eel your terminal to echo n flif " (cOntrohQ spaced. Since the normal print 
routines will actually send Sparrow Q> for <control-Q>, this is most easily done with the 
"echo" gadget ol 1he ThorlOn Bor, a smsSl connector which makes Ihe Thorton F3ox look 
Uke a lull duplets computer line. (II you want to mate yourseH o*¥ 3 see General Turtle Or 
Mark Miller; you probably won't need it.) 



I6j .Turning On 

Assuming you are. plugged In and- logged into ITS. you may now run either musk 
box in LISP Or LLOGO. LLOGO will ask you i( you want the music box; IF so. ii will ask. you 
which c-nei if Ihe new one r it will ask you which port |t ■$ plugged into. Alter answering 
■ll questions, lype $TAflTMif$tC. It will lell you to turn on the music box (the OFd One 
will make a lot ot noise), and then lype UK. Then, the noise (if any) will stop, and you 
■re ready lo go, LLOGO behaves much like other LOGDs, and understands the primilivei 
below. 
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Th» musk bo* can also he run from g pure LISP. Type (FflSLOA!) MUSIC FflSL 
Q$K UJQGQ), ind answer (he quesliOns. Type (STARTHUStQ and the following, 
primitives will behave like l-SP S1£PS 0^ F&U8RS. <lf you do ffHflmr hacking, see k/arK 
Wilter.) 



I fi.3 Music Primitives 

A p r rr»t deal Of eflOrt has gone inlo ensuring upward compatibility with CLOQQ 
and 11 LOOO. II you have programs far either of those which no longer work on LLOOO, 
please let me Know. Notrce that many "inlermadiate" level Functions such as CHORUS, 
whrth had been wnlten in LOGO code, are supplied as LISP priimbve* for eMiuehcy- n 
addition, new facilities he^e been jeWed which should be helpFul. Fn the following, all 
such situations have been indicated 1 . Occasionally, a single function replaces seve r al 
LQGO functions; the others are still available, "out may print i message recommending Ihe 
newer function lor fgtur* code- Since most music- functions are ewecu'ed *ot effect, 
unless Otherwise indicated, Ihe value of a function Is |t^ ?tom <wOrd> ?, 

BOOM 

Relurns I ha number which corresponds |q i drum beat. Using BRUM it more 
efficient. No inputs, 

BRUSH <dura.liali Jinl> 

Takes 1 input, a list of durations. Plays ti.e. stores in the music buffer for the 
current voice} a sequence of brush notes (see GRITCH) and t**1=. A duration of n 
means I brush followed by n-C Tests. 

CHORUS <fawm t> . r , . <fam 4> 

Takes irom one to four inputs, which should be forma (procedures with 
arguments, or constants] CtfQRUS evaluates each argument in turn, and t^n £0es on To 
the neit voice, in cyclic Order, and eva'ualas the next argumenl. E* ample: 

*CHORVS STNC i JS 5JJVC 5 FO RI\G $ Jfl 
Tf**f 

If the number of inputs Is the same as jWO/CES, sequential calls 1o CHORUS or 
SING will do thn expected thing; if 1he number of voices used by Ihe arguments is equal 
to -NVOICES, recursive calls will also work. For ottier situations, jus! remember that 
tVQICR is updated alter evituating each argument- F?r n-rarrplu, if iWOiCKS ■ 3 and 
you CtlORt'S two calls to SINC, the re*1 call to CHORUS will alfect voice 3. 

CHORUS2 <ftttm J> </Wm 1> 

Version of CHOWS which lakes exactly two arguments. For upward 
compatibility Only. 

CHORUS J <ft>rm l> </V>rm 2> Sfarm 1> 

Analoaous to CHQRVS3. 
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CSfOnUSi Vorm I> </erfli t> ^n 3> "farm 4> 

An*l0 E 0U5 to CJJOfil/SJ. 
DJH/W <Nir e/ dural fobi^ 

Analogous to BRUSH fa* drum note* (set BOOM}. 
GRfTCIf 

fleliirns the number ccHrespondirg lo 1he brush sound of Ihc pertussin speaker. 
More efficient Id use BRUSH. 

MAKETVNE <*tme iwm«> 

Takes as input a name, like LOGO MAKE or LISP SEF. ft multiplexes 1he buff** 
jinrl save* i1 as Ihe "thing" dI the na^e. T'ibI ii, it store* the lune as dais, as opposed to 
procedure-E. This r*HOws faster p-layi*^ {see J 1 J J ^TTT/iVfi> and easy storage (S/lffTd with 
plher LOGO variables.) Sirce MAKHTVNE does not clear the butler, allow? saving and 
playing incrementally larger portions ol a long piece. lures made on one musk ho-* can 
be played an the other,, with the eiEcepbon 1hat lures with exactly three voices can 
ncupr be played On the n** music box (see NYQICES). MAKRTUNE dtd not exist in 
CLOGOor J I LOGO. 

MRVFCLEAR 

Mo inputs. Clears |ha musk butler, and starts it yoke J. This should be dpne for 
enampte, afler typing *C 10 hill an unpleasant sOnft, Or »fter MAKETUNEin%. th* hrni 

yrrtiOfi oi * sOng, hefurfc starling a new one. 

MRUFCGVNT 

Same as m^JV. 
HBUFJNJT 

No-op. Prims message to let you know you tried ta use this relk of Ihe past. 
HBUFNEXT 

No-op. <5ec MBUFlNfTi 

MwrrvT 

No-op, (See MBUFf JWH 

No inputs. Plays the inus.it buffer. Does not clear it. 
MCLEM 

S*m* as MBVFGLEAR. 
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WLBN 

Returht the duration Qi the Icmgest rVOICE treated so far (since the last 
W fM/FCErtft). Usetul lor building procedures such as percussion a^cOmpan imertts for 
srb^rary length tui^es. (see VLEN, MAX) 

MGDMLSlC *T or N1L> 

Takes One input, NIL or Otherwise. I' non-iW£, puts music in » mode where 
numbering is from to 59., and note 60. is the same as note 0, (i.e., (not* *nod $0)), $0 

that (inr rw;«d not w(>rl-y ^IjflUt Speeding; the rgigfl- g« the rmusic bO*. 

tfEWMV$t€ 

No inputs. InPcwmt system that you *i*h to US* Ihf n** my?rt box A^k^ which 
part music boif is plugged into. Normally user wHI not need la call JtRIF MiJSIC, is I ha 
questionnaire at load lime ^irfhces, See: (JLC.*f L'S/C, 

nohusic 

No-pp. Bee MHb'yPi/T. This Function may he rems'aled as a way to excise 1he 
music package, fat example, when one *a"ts to load the turtle package instead. 

NOTE *jrffcA* <fowutim> 

UnFurtunalely, (through no faul"t of LLODQJ, there are minor variations between 
11L0QO and CLOGO. The dHFerence between NOTE and SING is Or* such problem, 
According to LOGO n*mo 7 (8/10/73), JWrfi is the basic J 1 LOGO music command. It 
takes two inpuls, a p'tch and a duration. It numbers pitches chromilicelly From -Z4. to 
36. with being middle C, There it* also three special pitehes, as follows; 

-23. is ■ rest 
-27, is a boom 
-26. is a gritch 
-25. is illegal. 

+ 

11 LOGO NOTRi*r> *tso take multiple inputs. IL0QO music has implemented all uf this tor 
NQTF, encept the mufltip'B inpuls. The numbering is slightly different ffOm CLQQO S/iVC, 
which is elso irrp : emented in LL0G0, (fee: Slftttl. 

NVQfCKS *},!<& or 4> 

Takes One mp-ul, hopeiully 9 number between t m& 4. Sels jiWOFCES to that 
number, dears the buffer, and sets -.VOICR to 1. Remember 1hat 3 voices is illegal on the 
new music system, and will generate an error. It is generally beMer (0 use tour voices, 
CTie blank f so that tunes will play on either tmnsie bon. In MQDMVSfC T mode, (normally 
not the case}, calHr^a fiVQJCKS with a number outside oF [Ifi.] will not catrse an error, 
but seems crazy. The 1* input mod fl will be used instead. -SJ?ring INVOICES Or 
MAkE<P% "NVOtCES" tanrvot be prevented, but is considered a faux pas. Accessing 
INVOICES is welcomed, CbHs MBUFCLE AR arid resets &01CE to 1, See: WQfCRS. 
iVOiCE. VOICES, WOUWI.'SfC. 

QLDMUSTC 
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No input*. Puts syslen* m mode for old music box. Normally no1 needed by user, 
■s Questionnaire- »t Ig-iJ time suffices. Might be used, (or example, if you made f mls|*ke 
answering I he questions. See; NEW MUSIC. 

PERFORM f Ahbrnvialiatt PH} 

NO inputs. Outpuls the music buFler, and 1hen does e-n WHt.'FCf.KAR. See: 
MBLfFO(/T h MBUfCLE^ PJ^yTlWE. 

PlAVJV,yR <!**!■> 

T*li* j one- iriM, wtiith must evaluate to a tune Creeled by HAKEWNE. it plays 
In* 1une. Does not deaf or olherwise alter (he- current mus.ic buHer. PI.AY'TVNf, Is 
Ir«napare-n1 to (he -current number el voices, even it lh* tin uses a different number. 
Sn: MAKETVME k PM. 

REST 

No inputs. Returns the number at the note which generate* jilrntp on lb* music 
bw. CLi'hv POOW and Cfi/rCtf, this *Hl win independently of whether Li LOGO or CLOGO 
prirnMives are being used; likewise, il will be the correct number few MODMUSfC T Or 
nor ma! slate, e^en lor different «*1abi*e$.> Naturally this checking re teas sfliciBiwt lhan 
jus! caMmg, SING -25. or NOTE Sfl. fc :he Bppropfiate duration. See: SJrVTJ, TOTE, 
MQIWVSfC, :SCJ1F,J5J?/MJ5- 

KfiSTjiUtrJftFiriG 

No inputs. Like SrfllrTJHI/S/G en«pt re-initialir.es alt system variabfes, and runs 
questionnaire as far back as asking which musk bo*. Useful in sctuihcms ol 1olal loss 
after panic procedure, usually tunes created by MAKETUtiK, and user procedures will 
be intacl. Buffer will be wiped out. In eases of peculiar behavior at login Or FOad time, 
guarantees that everybody thinks I hey hive the cranee you 1hink 1hey do. If this does 
not wOrfc, go to "PLUGGING IPf. 

SING <piir.k> *duratiiin> 

Basic CLOGO and LLOGQ music command. Takes Iwo inputs, a pitch number, and a 
duration. It is highly recommended that durations be integers g'ealer than 0! Very large 
durations (each unit corresponds 1o a charader atom in LlSP> irt apt to slow down Ihe 
system a lot, so small integers are highly advised. Pitches are from -25. to 39., with 
beme middle C. (But see the remarks about II LOGO'S variant, NOTE, *nd also 
:SCALERA$E and MQDMUSTC} Pitch -25. is a rest, -2 J. a boom, -23. a firitch t -22. 
ignored. (Qui see REST, KOflM* CRiTtH) Durations are normally broken down into M-l 
heats of pitch and 1 beat of rest, to avoid slurring, the music. However, it the SPECIAL 
variable \iftSTKUHENT is "STAKEtfnf,, 1 beal d1 note fot lowed by N-l beats oF rest 
will be sung, (i.e_ stored in the -music hulfer under the current voice), tf other phrasing 
is, desired, it may be addeo" laler. 

SOJVG <pilrtmt> <d»rclHM)^ 

Takes IwO mpuls, a Iis1 01 pitches and a list ol durahons. Calls HtffG, pairing 
pilches with durations, until the shorler list is exhausted. In ulher LOGO*, this, was not a 
primitive, but was wrilten as ■ recursive LOGO procedure. 
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STARTMUStC 

No inpuls. Should be called to turn on the music bos. Unlike CLOGO, it pauses lo 
lei you lurn an th* box, to minirrnfe. the uhpt*totr*t noise generation on (he aid music 
box. iPKRFDftM alone will suffice). Clears Ihe musk; bid Far And set* :VOlCfc" 10 1. 
Probably unnecessary with new music bo*. 

VLEN 

No inputs. Returns duralion of current buffer, See: MBVFCOVW, .MAX, 

MLEN. IJseiul when chorusing a lune wilh an acccTpa" ment. I' (he accompaniment is 
Ihe |«t ai-ftymenl to CHORUS *md contains a stop rule like, 

IF fLEN - MLEN THEN STOP 

the BC&0?npBniiMnt cin bo urjtd with arbitrarily long tune*, 

P0JTCE <iHjicr-> 

Sets -.VQICE to its one innul. provided Ihs1 input is a positive integer less than 3. 
if greater thin the current number o* voices, NTOJCE5 i-s tilled lo merest the number. 
AH fnusit irotn now until tho na^t till to tWCE iot % primitive like tUOn'fjS which calls 
VQICK) wiH go info this, voice. All the voices in use will be mullipleired prior to 
PERFOFMing the buffer. In MGDHVSK T n*c«fc rnputs greater Ihan fl. (Jo not cause 
errors, bul Are simply cycled through Ihe allowed voices. *MK£irg (LLOGOI Or StiFing 
(LISP) :V0!CE is not nto. 

VOICES 

No-op. See rTOMt/SJC If anyone has, i use for this which is reasonable, e.g^ 
synonym for HVGICKS t l will be glad lo implement il. 

■INSTftUWENT 

Special system variable which is user settabfe. Its value determines the behavior 
o< rWTE and 5/ JVC as above. Current meaniiigful modes ar* LEGATO and STACCATO, 
Anything else is considered STACCATO for now. 

-MAX 

This pscudo variible is actually a call to JkrfJEiY, above. II s*'s1s Tor compatibility 
with CLOQO. 

■JWOKBS 

Special system variabre, not to be chined eiccpt by calling NVQICRS. It tells 
you th* number ol voices being tilled Or played il present. Def auM is Z. 

:VQtCK 

Special system variable, to b* changed only by calling VQiCR. Tells you Ihe 
current vole* Ihtt Is being filled. MEliFCLEAR resell lo 1. Always initialized lo 1. Can 
be changed by call to CHUfltSS, 
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Special sysTom variiblfr *hi^h may be changed by user. Ft 1«l!s the o'fE*t IrCrn 
middle- C tn be used in renumbering ntilei to Ones lasta, Dtfvuli \i ItrQ. 
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TV SIZE 

Returns a Ife t confining Ihe hcriztmlal and vertical sires ol (he diEpfay are* in rirttw 
pcin^. The default site is 300 * 900. Hit dimensions of Ihe entkt TV ttrien to 355 Jyerticak] x 
57G [NjrijflfiUIJ, 

7TSfZE<Fww-ifw> 

Sett both Ihe horizonlal a^rd vertical sizes ol the display area lo <jirv-jixr>. Modifying. I ha 
TV SIZE causes a CLE/iRSLREEN 1o be perf a r rtted. The tiie n1 Ihe are* al Ihe hot him of the screen 

for typein and typrOul is adjusted* 10 lake up as much space as possible on the screen not being 
used for graphic output. Changmg En* TV$IZF t wrll not h|\>e any eflett on pxturst previously saved 
by AMJKrWfMKJ.P [see Seel ion 17.16]. 

TV'STZE ~*-tmin-x-iizit> <-ririn-y-iiz*> 

Sets the horizonlal and vertical sizes independently. It either at the two inputs it Nil*, the 
corresponding slie remain? unchanged. 

Returns a list containing Ihe horizontal and verticil sims of Ihe display ire* l-n turtle 
coordinates. These are in I la a ting pojnt. The initiil default rs 1000 t, 1000, a»n) the origin is always at 
the center of the screen — so turtle coordinates initially range Irom -500 lo *500. If wraparound 
made is *rv effect, turtle epprdinates are albowed above and below Ihe range sel by TURTLES t ZE, 
and will be mapped 10 appropriate points On Ihe screen. 

TVHTLESIZK <*«w-h«> 

$e!s trie dimensions of Ihe screen In turtle coordinates to <jhm*-jim> turtle stept, tl the 

display arc* is nol sqi/are [thai is, if the horizontal and verier TV silt pirimelers are not equal J 
ttien <jiei0-Ji£e> is laken to be the number oF turtle steps tor 1he mirnum dimension oF the screen, 
and the other dimsnj-ion is adjusted accordingly. Jn particular, you cant specify TUKTLESIZE 
independently in each direction, so that a lurlle step always corresponds to the SJrne number cf TV 
pOinls. Changing TL/'HTLKSIZK has no el feet on the piclure currenlly being displayed, or on any 
pictures saved by MAKEWIKDQW. 

SETH0ME {TfJRTLEttQME} 

SETHGMK <™w-x-l,{>n™> <™ V -y-k(?iH*> {Till 

Changes the origin of lurlle coordinates to the specified local ion, defaulting to the turtle's 
present position, That pOoihOn on the screen will then correspond to an JtGtifl and YCOft Of zero lor 
all subsequent turtle commands. The home tocalion is Ipcit to etch turtle, to that tatta of several 

(u riles may be assigned diFferenl homes nn the screen. 

m 

17.15 Scrrtn Color 

The Knight ttrminaks havn a facility for aasily changing whelhar bits which are On in Iht TV 
memory will be displayed as dart or light on the user's screen. 3y analogy with a photograph, i-n 
"negative" made, poinls which are on [graphics and taxi J will be displayed as light on a dark 
background. En "positive" mode, they ?re displayed as dark on a light background. The current it ate 
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of « user'? terminal tmb« complemented by typing <£SO C The following lurcho* *!■&* H to be 
ex amine-d- and cOnlrOllod by a user program. 

COLOHSTATE [CLST\ 

T ill I he user is in *pdsi1ive" mode, NIL it in "negative" mode. 

CQUJRNEGATIVE (CtrVj 

Ptits Ihe use* in- negate mode, i.t light led and (h*«* on a d»*fc background, This, is the, 
mod* in effect initially al login linn. 

CpfjOSPPJ^JHf JCLP) 

Puts Ihe U?er in positive made; dirk te*1 and pictures, on i light backgrOund. 

COLORS* ITCH {CLAW} 

Complements the GOUJttSTftTEi it Ihe currant mode Is negative., switches to pOfrillve mode, 
pr vice vers*. This has the same e Fleet as lyping <F$C* C on the terminal. 

17.16 Saflne Pictures 

In crofting, pictures which consist of f*p#*tinf putter ns of smaller pictures, and creating 
a nitrated car toons, it is often useful lo be able lo save displayed pictures drawn by a series of 
turtle eon*mands r and operate upon them as a unit, displaying and erasing I ham-,, moving them to 
other parte ol the screen, etc. The LLOGO TV turtle provides such a facility, allowing, the user to 
sav'e reel angular portions of the screen as arrays of paints. These arrays can be displayed and 
erased ait any location On the screen,, although Ihey cannot be automatically rotaled. 

This fteHily is somewhat different horn the SNAP connnand in the LLOGO 330 turtle end 
1 ILQGO. The SiY/lP operation saves (he picture as display li-ils, essentially a vector representation, 
while the TV turtle window saves an array o1 poinls. For large, sparse ptclures, the vector 
representation consumes less spare, -*nile the point »rr*y representation ievcw* smell, cample* 
pictures. Saving point arrays makes it possible to redisplay pictures much more rapidly than 
redrawing ttiem wilh tne commands Used to originally generate the picture, since rec-Omputation ol 
paints lying slang vectors is unnecessary. 11 is there Fore ideal lor programs which want Id make only 
taw, r.patially localized changes lo a picture, but need 1he maximum possible speed for dynamic 
updating oF 1he screen. U also has the advantage thai Ins amount OF space and lime used lor 
creating and redisplaying pictures is insensilive 1o the corrpletfjly of a picture witnin an area, These 
characteristics make an array representation more suitable than a vector representation for^ say, a 
space war program, where the space ship musl Im redisplayed rapidly, and consists of perhaps ■ 
large number of vectors confined lo a small area at Ihe screen. Jt also provides a 'clipping" facility, 

Saving point *rrays has a property not shared by LLOGO's SJV/JP lor the 310 — "Whit you 
see is what you gel". Everything within the designated area is included, regardless of how it was 
caused lo Pppear — vectors, test, points, other WINDOWS, etc, This moan* that yoo cart always tell 
what will be included in a saved picture simply by looking al the screen. 



Display Turtle lor the ftnicjlH TV Terminals BatHm 17. LB 



USF LOGO MEHQ Pi&* ?S Hurli 4 F J37S 

JWvlKfeTFJ/VWJfF <winrfo«-naiBff> <rh> {JflTJ 

Creates, a "window", lje. r an Mtty a\ point j, and names it ^injnJj>u>-n(im(i? The < coin Jdic- 
num^ should be a ward, and should be chosen so as nol to cOnllict with suiting functions Or 
arrays. The wmdow is centered en Ihe turtle's current localion, and extends, lor <ji^n> turtle slap; 
hOrizcmlally and vertically From the cantor. The local ion o-F 1he cental OF the window and its size are 
rturwmbtrajd. 

M/IKEWISDQW <\c\n4t>\irnamtr> ^htifitOHit'titi> <vtrtlcal -tlt*> 

Creates a window cantered On the turtle's current location, but sats the horizontal and 
vortical sizes Oi the window independently, so the area saved can ba rectangular instead of square, 
as in the one input mode. 

MflKEWINDOW «Swpndaw>-harJir> <E*ttflr~3> <otT\HT-f> *f>orit<mtat-ti*e> <u«rtital-tin> 

Creates a window centered on the speciFied local ion, oF Ihe specified size. !f the <mrf.fcal- 
«*e> Is Omitted it is assumed identical 1o tho *tnmmnial-tut*. 

FFfMjLRIFINOOK' ^-mWuic-rrnmn.* {EFT? 

Destroys I he window speeilied by ^Bjindain-nflinfl^, ]f the window it no longer needed, ttlto 

prrmitB Tho space that 4! occupied to be r«cliim?d, 

ERASEfFWDQfFS JEFF?) 

&IH4 *H currently defined window*, 
WINDOWS 

Global viable wfuth contains 1 Nst 0' tl ■currc-ntlj' defined windows. 

WINDQWFR/IM F . . . . \W¥\ 

Takes inputs Irke M/iKEW INRfflPi except for 1he window name. That is, it lakes prom one 
to 'our inputs specifying 4 size and Optionally a center local ion. WINDOW Fft/iME displays a box On 
the screen which indicates the extent oF the picture which would bo fayed by a M AkKW I \\DOtF ol 
1he corresponding size and location. This is useful in deciding how targe ■ window is necessary 
before using MAKEWfNOQW. The bo* ii XQflfcd <pIq tho scraen, to that giving the 
WINflOWFR/iMii cOrnmahd agai-n will cause the box to disappear. If no inputs are given lo 
WfNQQIFFRAMF, the size and location deladt ta the l*±t one? specilied- 

SNQWWINOQW <rarjJoiE-jiamn> [$W] 

Causes the specified window 10 be displayed al Ihe location at which it was originally 
created. Currently, wraparound is hot allowed; display 01 the picture is not allowed 10 crOss the edge 
of Ihe display area. Changing TV 51 IF. and TUKTt&SSZE have no alfeel on the sire of sevod 

pictures. 
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StfOWW I NO€W <w&ndavi-nnm«> <ri*w-r.iir\tr.r-i> *-nnrn-cmntMr-tf> 

Causes the window la be displayed at t^e new location specified. 

IIWBWlttDQW ,,,, {JfSPj 

Accepts arguments like SJffJtriFJA'OfHF, but displays (he window turning off jny point 
which was On in 1he window when it w» created. The efed af this is as il the piclure went 
redrawn in eraser mode, H * tall to SfiOWWIPiiXtH' displayed the window On i falanfc ores, a 
similar tail to HiDEWINDOW will erase it. If SHOWtFltiDOW superimposed the window On 
=on-,n Thing ako»dy displayed, the old pictur* is nOl guaranteed lo remain inlacl after I he window is 
hidden, 

XORWlNDQW [XW] 

Like HffOtFiPIMKW and IIIDZWINDQW, but XDfTs the picture inlo the screen. 

WINDOW HOME <ninio*w-*am& \Wli\ 

WINDOW It (IH IS *toin<!tnimamt> <Newk*Aam4> <nnv-y-hvmif> 

Changes the home local ion associated with a window to Ihe specified location, del Bulling to 
HERE. This i. tha iocalion *h*re the tenlmr of the window will be dis played it only the name of tha 
window is given a* input to SiWW\FtN!X}W, HIDhWISDOW, ale. 

SAVEWINDOWS «j"Uf*pcc> {SWS} 

Creates a file on I he disk which sa^es all currently dfthned wihdQws in bmary. They Can be 
reloaded at a later fme with VETWIfiDOWS. The file specification follows the sunn iortnal as other 
LLQQQ file commands such as READFILB, and LISP'S UHEflD. Tha filenames are not evaluated. 

CE1WINDQW5 *fltetpet* {CSFJ 

Reloads windows rrom a disfc tile created by $AV EW I NDOfFS- 

17-17 Pf inline Fiotuwj en the XGP 

Pictures drawn with tha LlOGQ TV turtle may be printed on the A] Lab's Hero* Graphic.5, 
Printer lo ebttin hard copy. The following primitive creates ■ die which can be printed by I he XGP 
con! rot program ?CRTFJP. 

XQP <JH*> *nrt4> 

Creates a file saving the picture in the designated area of the streen. TFi* file can than b# 
printed on the XGP. The fiie speedication iollow* the same Formal as Other LLDQO lile commands ~ 
frcMn One to lour words. A reel angular area limiting the picture saved is specilled ift the same format 
accepted by the window commands — from one lo Four numbers. IF qmitted, the *f*a default* to the 
eniir* screen. E7* ample: 

XGP PtCTVRE > 200 ,100 100 

saves the picture extending for ICO turtle steps horizontally and vertically from the point f20O, 30O) 
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In the file PICTURE "» on the current direclory. Captions can be printed On ths riree-n using the 
iW/IKK command end will appear on [he pnnfed picture. The pictures will he apprcKimalely the same 
size as they appear On the TV screen. Currently picture* sa^ed are Hn«led to WO *y -WO TV paints. 

Two warnings concerning XGP pic lures: First, the XQP has a problem common to all XOTOK 
machines — an inability to reproduce large black regions. An attempt to 0"n1 A picture with areas 
lilted in blaCh. will cause ft* bldi h. ^ions Id "*hite duI" Pictures created by using the SUJ1DH 
command to shade regions with -dense palterrrs will n$F be prinled correctly On the XGP, Aviso, if Is 
best to try In limit I he area ol the screen saved to as small an area as passible. Since picture lile-s 
must be Output to the VGP last enough to insure that Ona line Is printed before the next One «s raeo, 
large fries may luse when the system is crowded. The symptom of this sorl of lossage is blank 
horizontal bands in I he middle of the pictu T e. More efficient XGP commands to be implemented sOOn 
■will reduce Ihe liifcelihood of Itiis sorl of losssge. rmsges on the TV screen dra*r> by the TV turtle 
can alia be prinled using the TeHdroni* hard copy machine. 

17.18 ShicHwc 

A unique advantage ol the TV displays o^sr vector oriented displays is I hit in addition to 
Ihe display ct line drawings, 1hey make feasible the creation ol pidures using shaded areas. 
Patterns of points ol varying densities can be used to Ml regions creating ihe effect of • 'grey 
scale'. The TV turtle's shading facility is aimed toward creating a convenient and efficient: means of 
specifying areas to be shaded* and patterns to be used in shading. The basic idea is that regions to 
be shaded are indicated by drawing a closed curve around the<ti in PEiVDQIFN mode, and placing trie 
turtle inside the region be'Ore issuing the SlfADti command, with an argument determining Ihe 
pal'ern to be used. Several simple patterns are supphed by the system t but the user has Ihe 
Opportunity ol defining new anas. 

SHADE tpflir*™ noiM> 

Shades 1he are? enclosing the turtle's currenl location. The input is a pattern to be used in 
Shading the area, and debits to the SOUfi pattern if omitted. The turtle rnust be Sitting in *n 
empty area [not on a line or in a filled in region], or an error results. The el Feci Ol this primitive is 
to till m the region surrounding the turtle 1 ? location with the shading rj:ilU:rri yiv*n, [by inclusive 
ORing it in with the existing picture} fhe region to be shaded must be bounded by a dosed curve; 
SHADE works by filling in the pattern starling From the turtle's local ion, and stopping when a 
boundary is reached. If the region is not closed, the entire screen will b* shaded! 

17.19 Shading PaMeriiJ 

Shading patterns are represented as functions whith tell the SH/IDK primitive how tp 
shade an area. The system provides a a/cup of predefined shading patterns, described below. These 
will ptobahly be sufficient for most simple uses of shading, i_e. distinguishing a few neighboring 
regions wi1F> diFferent shading paltems, etc. Those needing more sophisticated capabilities can define 
their own patterns. The predefined shading patterns currently available are: 

SQUD 

A. shading pattern which Fills in every point. Thti pattern n the default used if no argument 
Is given la SHADE. 
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CHECKER 

A pattern which fills in every other poinl, in checkerboard fashion. 
HOMZLINES 

A p»ltfrm consisting of honzonlal lines. alternating light and dark, 

LiKe JfGJK/ZJ./.'VeS, except lines are vortical. 
GHit) 

Both horizontal and vertical line*, superrmpOsffd. 

tExnms. 

A pattern which turns on points, randomly, creating a testluro hk* olrVct. An overage of half 
the point* will bo turned On. 

D/IRKTSXTURE 

LtGItTTEXTVHE 

LlKe TKXTUHE, but shade using dhferent densities pi points. D/lfJKV'OTTj'fi'E' turns on an 
average Ol 3/4 Ol 1he points, created by OR'ing two- random numbers, LIQHTTEXTVRK averages 

1/4 of the poinfs^ obtained by AJ0>n| two random numbers. 

Mow shading patterns consisting of arbitrary pictures can be defined by using the- following 
primilive: 

MflKEPATTERN <pAiicrN-n«ma> ^iuNdWnajTi«> (JWPj 

The first argument is a na-np For 1he new pal tern. The second Is- the name of o window, 
constructed by ths MAfiEWlMMllf command This weak} a n*w pattern, which consists of Ihe 
picture saved in 1he window. The pattern n a,mo may Ihen be given as input lq SWfWE. Th* of fat 
will be- to fill the dosed curve to be shaded with the picture specified by the window. Ef area 
biryGr«l the extent of the original picture is to be shaded, The picture will be repeated hori«inlaHy 
and virtually a$ rn-any times as is necessary ta fill the area. 

Alternatively, a shading pattern may be constructed by the User directly as a function, [Thisj 
tan result in faster shading than by using a pattern conslrucled by HAKEPATTERN, although pi's 
more difficult la write, especially for -complex patterns.] A pattern Is a lynctifrn Ol two integer 
arguments;, X. ?nd V coordinates ol a word in the TV memory [as lor the inputs to TV, Bee Section 
17.2?]. It returns an injeger, which indicates (he stale Ol 32 bils Ol Ihe screen, left justified. 

17,20 Invisible Mode 

When a program dots both- a considerable amounl at graphics as well as non-sjripNIt 
computation, il olten becomes, convenient to be ebb lo debug these comporente separately. An 
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"invisible* mod* makes it possible to debug; the ran graphic parts of b program -containing lurlle 
commands, wlthoul incu^inj (he overhead of dnwing on the screen. Whom the system is heavily 
loaded, coda run in "Wisi hia* made will run mm h IjviIit, fllpwihg; the user to run * procedure H he 
is rait interested in the pidure drawn, then return To Visible" rrode to debug the pictures, drawn by 
the prolan*, Pictures drawn in i-nvtaibie mode are nol saved md returning to visible made require* 
that programs ba re-ejretuted tg observe the picture drawn, 

flWISIBLE 

Enters "invisible" mode. Any primitive I hat would cause changes to pictures on Ihe screen; 
movement ol the turtle,, display of saved pictures, pomls, «lc, will not cause anylhing On Ihe screen 
lo change wh.-le running in invisible mods, E«*tution OF procedures containing lurtle primitives will 
proceed much faster j this permits running Of procedures containing turtle primitives lor the purpose 
of debugging; their non-graphic behavior. 

ViSiBLE 

Fe-turns to "visible" mode. Turtle (unctions have Ihalr usual o-Fiott, as well as I heir usual 
slaw nets. VISIBLE causes a CLKARSCRREN, 



Lj,2l Eaten a ion* 

One posstblfr SOUrte- o' sponsions lo the TV turtle pact-age would br the inclusion Or 
picture -saving capabilities similar 1d Ihe SNAP coninnand of Ihe LLOGQ turtle Tor the 340, Or 1o 
11L0GQ'* SNAP. Thit would dilFnr from thp ^rndOws" described above in that it would be a lower - 
level representation Ot Ihe picture m terms ol vectors to be di$pl»-yedj rathe* lhar» an array Or 
pOmls. Because the TV terminals do nol have hardware for display or vectors, necessitating the 
compulation of points lying along a veclor lo draw it, redisplay oF a snap would be very nearly a* 
time-consuming as re-e:ietu1iivg the LOGO procedure wlrch drew the picture. En contrast, redisplay 
of p window bypassc-s lhal recOmpulaliOn, and requires much less time to redisplay 1han Ihe Original 
drawing procedure required. Ifcwever, a vector rc-prcscnlalion does provide several advantage s. ft 
is le-ss space-ton-suming For pictures which occupy Urge part on^ of the screen, buf conlam few 
vectors. It ■ean be used more ra-jily wilh pictures for which a description in terms oF rect.ana.uiaf' 
portions Ol the screen would be inconvenient;, lor example, in irregularly shaped picture surrounded 
by drawings not to be included m Ihe saved picture, The window representation make* it difficult to 
assign Independent name; to the saved graphic oulpul of each of several programs if the pictures 
Overlap. Certain 1rans Formal ions such as rotations ai*d scaling might be more easily performed on a 
vnt'.at rftp'Hf.nnla'Iien fh^n it- rum f *rr^y5. 

An additional difficulty in providing a snap Facility in |he TV lurlle similar lo I hat possible 
with vector oriented display $ would arise in implementing the ERASE SNAP command- ]F several 
lines all pass through a single point on the screen the point musl nol be turned OIF until all linn are 
erased. If one line Is erased vis ar. fiKASE SNAP. a"d olher lines still pass Ihrough the point, the 
poinl mus.1 not be turned otf. This requires t*epin( track of how many lines pass IhrOugh each pOinl. 
Such information could be on'amed From computing Ihe intersection and overlap of vectors displayed 
whene'er a vector is drawn or erased, Or by '-cepi-g a "reference counl* for each poinl, 
incremented whenever a line passing through the point Is drawn, decremented when such a line it 
erased. The "eraser mode - oF the TV turtle turn; olf points a'ong lin« drawn regardless Of Iheir 
previous stale. This makes it somewhat less convenient lhan ERASE SNAP For erasure of one of 
several overlapping pictures, although the tame eFleel can he achieved by saving the previous 
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contents ol #n area in a window before drawing over it. In soirte cases, KOI? mode can be used 
instead, so thai the same procedure can be used bclh Id draw a picture, and to erase il. 

Anotter alter nil ive representation fat picture elements would be run length encoding. This 
would record the contenls OF an area of the screen, as does the TV lurlle "window". Each line Of the 
area is represented as a sequence of numbers, The numbers in the sequentc alternately specify 
how many consecutive points are on, and how many consecutive points are olF. Like Ihe window 
Operation, this technique is capable ot being Used wtth pictures containing shaded areas, which 
woutd not be possible with a representation consisting solely of vectors. Although it would require, 
SOrnrwfiat more c OTputabcin. time- to redisplay thin would a winriiw, >f wOylrf not prove quite as 
space ccmjurrtinj for large and sparse pictures, |t is not de»r whether Eh* time end space tradeoffs 
involved would jusliFy the use OF this representation, 

Each alternative, representation for p'dura element? carries with il unique advantage? anrj 
disadvantages, In terms ut time and space eFliciency, ease oF modification, etc. Rather than becoming, 
committed to a single representation^ a better goal is to provide flexibility by making available many 
Options and allowing a user Or an intelligent system to choose the representation recording lo the 
requirements of the application. 

An alternative to the TV turtle's approach to pictures involving shading is to extend lha 
LOGO concept ol the turtle's "pen" and "eraser" to t "painl brush". A "paint" consisting of a parHculnr 
shading pattern and a width For the paintbrush would be chosen by the user. When the turtle is 
moved after 1he execution OF a HRVS f!D<)WN command, the shading pa! tern is drawn in an area 
extending far the specified width on either side ol the path of the turtle's inovetnertt. However', this 
rmethocj has (he disadvantage that programs lo shade <rv B n ypry simple geometric %ut«s t »h become 
quite complicated. Thb mode mifthl be use'ul however, it it were possible 10 move the brush under 
control of some analog input such as a light pen or mouse. Another poss^My is to supply th# 
system with specilic knowledge about shading common shapes, such as circles. 

Other extensions to the TV turtle could center on providing facilities oriented towards 
animation. LOCO as a graphics language is primarily oriented toward the display of static pictures? II 
is weak in some OF Ihe capabilities needed for convenient generation of movies. A mora extensive 
vocabulary of transformations which can be applied to picture* would be heJpful. This Could include, 
rolatron and! scaling oF saved pictures, Ihree c^m&ns^nal {po-dinilt If ansFof (nations, as W«H « ■ 
convenient way of incorporating user defined transformations. Some means oF explicitly controlling 
the time in which changes happen to the displayed picture should be provided. Extension of lha 
control structure to allow parallel execution ol procedures ufOutd facilitate programming 
Independently changes to the picture which should occur ^m U l| a-nrdusly. 

Another capability which the system should have is some provision lor analog input, such as 
from a light pen, joystick, tablet, Or mouse. This wOuld allow the system to Obtain and manipulate 
freehand sketches. Convincing drawings of people or objects lhat would be difficult to conslruti 
from turlfe program? could be readily input and (hen manipulated by programs. Objects On the 
screen could be selected by a user inter actively using a rubber bard vector, which is often more 
convenient than typing, especially lor children. 

1?.22 lmp]frWfhtaitiDri 

The PDP1 1 which controls the TV terminals maintains Ihe user's screen in its mernory h one 
bit per point. An IT5 system call allows the It's memory to be mapped into the address space ol a 
program runnirrg on the PDP10. An initialization routine written in LftP assembly language performs 
this system call, and sets up an array header which convinces USP lhat trut area of memory is really 
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the data for a LI5P two -cfimenaional integer array. This array ie accBssibfe direclly by the user who 
finds the supplied turtle- primitives r*Ot swlcd to his needs. All changes, to I he display- screen are 
perfor-flrtd directly by U5P STOJTEs, and Iha remainder of the display pith*!* ■& wrMten entirely in 
U$r\ 

The following primitives are probably not ol general Interest, bul are. inlernal |q flu TV 
luMIe package, and m>gnl conceivably be OF use lo a user desiring nonslindard applications. 

TV <llni> ^eolumrt-iflsrO 

This- is the array which holds the user 4 s TV bufFer. A ciil to TV returns ■ 36 oil fixed pOinl 
number, which certains lwO 16 bi1 PDF LI words, left justified. STORE'S into 1he array will cause 
the array and the user 1 * screen. 10 be nodHied as described in Ihe discussion or DRAW MODE, 
helow, Arty such STUKtTs should keep the lo* prtfer four bits o1 each word iero. The first Input 
counts number of lines from 1he lop, from C to q&q. The second select* 4 word On [he line, lefl to 
right, frqrrt to 17 [1 Or a lotal Ol lfl i 32 - 57& bits per lino J 

The PDPkL has ? Feature whkh enables any attampt lo wrile a word in the U's memory 
fr&m trie PDPIO to result in a specif ied boolean (unci ion dI Ihe ward being written and the ward 
previously there. fiRAIFifQfiK changes thai specification according to tBisrf**, which should be an 
integer represenTing [hn inode chosen Irom the values; of orn; of 1he foHOwing atomsi 1QR. JKO"Jt. 
ANDC r SAME, GOtfP, KQV, SKTO t SRTZ, SET. For e» ample, STORE TV D 9 Jo will turn Ihe low 
ardor bit Of the second 16 bit word of Ihe IV bufler on \i IOR mode is in effect, cdf if ANDC mode 
is in effect, and cohriplefrienf whatever is there il In XQR mode. DRAW MODE returns the number 
de&cribing. the mode previously in eFtect. 

:i}RAWM)DE 

A global variable containing' the current mode number as set by the ia&t call to 
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